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。

Oid
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。 當迷你埠驅動程序報告 NIC 狀態 NdisMCoIndicateStatusEx變更時，NDIS 會將迷你埠驅動程式所指示的NDIS_STATUS轉譯為 NDIS 傳送至 WMI 的 GUID。

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

要求

版本：Windows Vista 和更新版本 標頭：Ntddndis.h （包括 Ndis.h）