OID_GEN_CO_SUPPORTED_GUIDS

OID_GEN_CO_SUPPORTED_GUIDS OID 要求迷你埠驅動程式傳回類型結構陣列NDIS_GUID。 陣列中的每個結構都會指定自訂 GUID (全域唯一識別碼的對應，) 自訂 OID 或迷你埠驅動程式透過 NdisMCoIndicateStatusEx傳送的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_ARRAY旗標時， Size 會以位元組為單位指定迷你埠驅動程式所傳回陣列中每個資料項目的大小。 如果已設定fNDIS_GUID_ANSI_STRING或fNDIS_GUID_NDIS_STRING旗標， Size 會設定為 -1。 否則 ，Size 會指定 GUID 所代表之資料項目的大小，以位元組為單位。

旗標
下列旗標可以是 ORed，以指出 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_GEN_CO_RCV_PDUS_NO_BUFFER：

NDIS_GUID NdisGuid =  {{0x0a214809, 0xe35f, 0x11d0, 0x96, 0x92, 0x00,
 0xc0, 0x4f, 0xc3, 0x35, 0x8c},
 GUID_NDIS_GEN_CO_RCV_PDUS_NO_BUFFER,
 OID_GEN_CO_RCV_PDUS_NO_BUFFER,
 4,
 fNDIS_GUID_TO_OID};

GUID 是 Windows Management Instrumentation (WMI) 用來取得或設定資訊的識別碼。 NDIS 會攔截 WMI 傳送至 NDIS 驅動程式的 GUID、將 GUID 對應至 OID，並將 OID 傳送至驅動程式。 驅動程式會將資料項目 () 傳回至 NDIS，然後將資料傳回 WMI。

NDIS 也會將 NIC 狀態的變更轉譯為 WMI 所辨識的 GUID。 當迷你埠驅動程式報告 NDISMCoIndicateStatusEx的 NIC 狀態變更時，NDIS 會將迷你埠驅動程式所指示的NDIS_STATUS轉譯為 NDIS 傳送至 WMI 的 GUID。

如果連線導向迷你埠驅動程式支援自訂 GUID，它必須支援OID_GEN_CO_SUPPORTED_GUIDS，這會傳回自訂 GUID 與自訂 OID 或NDIS_STATUS字串的對應 NDIS。 使用 OID_GEN_CO_SUPPORTED_GUIDS 查詢迷你埠驅動程式之後，NDIS 會向 WMI 註冊迷你埠驅動程式的自訂 GUID。

規格需求

版本：Windows Vista 和更新版本 標頭：Ntddndis.h (包含 Ndis.h)