OID_QOS_HARDWARE_CAPABILITIES
过度分配的驱动程序发出对象标识符 (OID) OID_QOS_HARDWARE_CAPABILITIES 的查询请求,以获取网络适配器的 NDIS 服务质量 (QoS) 硬件功能。
从 OID 查询请求成功返回后,NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_QOS_CAPABILITIES 结构的指针。
注意 对于支持 IEEE 802.1 数据中心桥接 (DCB) 接口的微型端口驱动程序,NDIS 处理此 OID 查询请求。
注解
NDIS_QOS_CAPABILITIES结构包含有关网络适配器的 NDIS QoS 硬件功能的信息。 这些功能可能包括当前由 INF 文件设置或通过 “高级 属性”页禁用的硬件功能。
注意 无论启用还是禁用某个功能,网络适配器的所有 NDIS QoS 硬件功能都通过 OID_QOS_HARDWARE_CAPABILITIES 的 OID 查询请求返回。
微型端口驱动程序在调用其 MiniportInitializeEx 函数时注册网络适配器的 NDIS QoS 硬件功能。 驱动程序通过以下步骤注册这些功能:
驱动程序使用 NDIS QoS 硬件功能初始化 NDIS_QOS_CAPABILITIES 结构。
驱动程序将 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的 HardwareQosCapabilities 成员设置为指向 NDIS_QOS_CAPABILITIES 结构的指针。
然后,微型端口驱动程序调用 NdisMSetMiniportAttributes 函数并将 MiniportAttributes 参数设置为指向 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的指针。
注意 在绑定或附加操作期间,NDIS 不会将网络适配器的 NDIS QoS 硬件功能报告给过度使用协议和筛选驱动程序。
有关如何注册 NDIS QoS 功能的详细信息,请参阅 注册 NDIS QoS 功能。
返回状态代码
NDIS 处理微型端口驱动程序OID_QOS_HARDWARE_CAPABILITIES请求的 OID 查询请求,并返回以下状态代码之一。
状态代码 | 说明 |
---|---|
NDIS_STATUS_SUCCESS |
OID 请求已成功完成。 |
NDIS_STATUS_NOT_SUPPORTED |
微型端口驱动程序不支持 NDIS QoS 接口。 |
NDIS_STATUS_INVALID_LENGTH |
信息缓冲区的长度小于大小 (NDIS_QOS_CAPABILITIES) 。 NDIS 设置数据。QUERY_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。 |
NDIS_STATUS_FAILURE |
由于其他原因,请求失败。 |
要求
版本 |
在 NDIS 6.30 及更高版本中受支持。 |
标头 |
Ntddndis.h (包括 Ndis.h) |