共用方式為


OID_GEN_SUPPORTED_GUIDS

查詢時,OID_GEN_SUPPORTED_GUIDS OID 會要求迷你埠驅動程式傳回類型結構陣列NDIS_GUID。

版本資訊

Windows Vista 和更新版本的 Windows
支援。

NDIS 6.0 和更新版本的迷你埠驅動程式
選擇性。

NDIS 5.1 迷你埠驅動程式
選擇性。

Windows XP
支援。

NDIS 5.1 迷你埠驅動程式
選擇性。

備註

陣列中的每個結構都會指定自訂 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;

此結構的成員包含下列資訊:

Guid
指定為迷你埠驅動程式定義的自訂 GUID。


指定 Guid 對應的自訂 OID。

狀態
指定 Guid 對應的NDIS_STATUS。

大小
指定迷你埠驅動程式所傳回陣列中每個資料項目的位元組大小。 如果已設定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)

另請參閱

NdisMIndicateStatusEx