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，然后 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