OID_GEN_SUPPORTED_GUIDS
查詢時,OID_GEN_SUPPORTED_GUIDS OID 會要求迷你埠驅動程式傳回類型結構陣列NDIS_GUID。
版本資訊
Windows Vista 和更新版本的 Windows
支援。
言論
數位列中的每個結構都會指定自定義 GUID (全域唯一標識符) 對應至自定義 OID 或迷你埠驅動程式透過 NdisMIndicateStatusEx 函式傳送的NDIS_STATUS。
NDIS_GUID結構的定義如下:
typedef struct _NDIS_GUID {
GUID Guid;
union {
NDIS_OID Oid;
NDIS_STATUS Status;
};
ULONG Size;
ULONG Flags;
} NDIS_GUID, *PNDIS_GUID;
這個結構的成員包含下列資訊:
大小
指定迷你埠驅動程式所傳回數位中每個數據項的位元組大小。 如果已設定fNDIS_GUID_ANSI_STRING或fNDIS_GUID_NDIS_STRING旗標,Size 設定為 -1。 否則,Size 會指定 GUID 所代表之數據項位元組的大小。 只有在設定fNDIS_GUID_ARRAY旗標時,才會指定這個成員。
旗標
OR 運算符可以結合下列旗標,以指出 GUID 是否對應至 OID 或NDIS_STATUS字串,以及指出 GUID 所提供的數據類型:
fNDIS_GUID_TO_OID
表示NDIS_GUID結構會將 GUID 對應至 OID。
fNDIS_GUID_TO_STATUS
表示NDIS_GUID結構會將 GUID 對應至NDIS_STATUS字串。
fNDIS_GUID_ANSI_STRING
表示已為 GUID 提供以 Null 結尾的 ANSI 字串。
fNDIS_GUID_UNICODE_STRING
表示已為 GUID 提供 Unicode 字串。
fNDIS_GUID_ARRAY
表示提供 GUID 的數據項陣列。 指定的 Size 表示陣列中每個資料項的長度。
fNDIS_GUID_ALLOW_READ
設定時,表示所有使用者都可以使用此 GUID 來取得資訊。
fNDIS_GUID_ALLOW_WRITE
設定時,表示所有使用者都可以使用此 GUID 來設定資訊。
附註 根據預設,迷你埠驅動程式提供的自定義 WMI GUID 只能供具有系統管理員許可權的使用者存取。 如果迷你埠驅動程序支援該 GUID 的讀取或寫入作業,具有系統管理員許可權的使用者一律可以讀取或寫入自定義 GUID。 設定fNDIS_GUID_ALLOW_READ和fNDIS_GUID_ALLOW_WRITE旗標,以允許所有使用者存取自定義 GUID。
請注意,迷你埠驅動程序註冊的所有自定義 GUID 都必須設定fNDIS_GUID_TO_OID或fNDIS_GUID_TO_STATUS(絕對不要設定兩者)。 所有其他旗標都可以使用 OR 運算子來結合。
在下列範例中,NDIS_GUID結構會將 GUID 對應至OID_802_3_MULTICAST_LIST:
NDIS_GUID NdisGuid = {{0x44795701, 0xa61b, 0x11d0, 0x8d, 0xd4,
0x00, 0xc0, 0x4f, 0xc3,
0x35, 0x8c},
OID_802_3_MULTICAST_LIST,
6,
fNDIS_GUID_TO_OID | fNDIS_GUID_ARRAY};
GUID 是 Windows Management Instrumentation (WMI) 用來取得或設定資訊的識別碼。 NDIS 會攔截 WMI 傳送至 NDIS 驅動程式的 GUID、將 GUID 對應至 OID,並將 OID 傳送至驅動程式。 驅動程式會將數據項傳回 NDIS,然後將數據傳回 WMI。
NDIS 也會將 NIC 狀態的變更轉譯為 WMI 所辨識的 GUID。 當迷你埠驅動程式使用 NdisMIndicateStatusEx 函式報告 NIC 狀態變更時,NDIS 會將迷你埠驅動程式所指示的NDIS_STATUS轉譯為 NDIS 傳送至 WMI 的 GUID。
如果迷你埠驅動程式支持海關 GUID,則必須支援OID_GEN_SUPPORTED_GUIDS。 此 OID 會傳回 NDIS 自定義 GUID 與自定義 OID 或NDIS_STATUS字串的對應。 使用 OID_GEN_SUPPORTED_GUIDS 查詢迷你埠驅動程序之後,NDIS 會向WMI 註冊迷你埠驅動程式的自定義 GUID。
要求
頁眉 |
Ntddndis.h (包括 Ndis.h) |