OID_RECEIVE_FILTER_ENUM_QUEUES

过度分配驱动程序和用户模式应用程序发出OID_RECEIVE_FILTER_ENUM_QUEUES的对象标识符(OID)查询请求,以获取在网络适配器上分配的所有接收队列的列表。

从 OID 查询请求成功返回后,NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_RECEIVE_QUEUE_INFO_ARRAY 结构的指针,该结构后跟每个筛选器的 NDIS_RECEIVE_QUEUE_INFO 结构。

言论

NDIS 从从 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 接收的数据的内部缓存中获取了信息,并 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 请求。

过度配置驱动程序和用户模式应用程序发出 OID 查询请求,OID_RECEIVE_FILTER_ENUM_QUEUES枚举网络适配器上的接收队列。

如果协议驱动程序发出请求,则 NDIS_OID_REQUEST 结构中的请求类型设置为 NdisRequestQueryInformation,并且此 OID 将返回协议驱动程序在网络适配器上分配的所有接收队列的数组。 如果用户模式应用程序发出了请求,则 NDIS_OID_REQUEST 结构中的请求类型设置为 NdisRequestQueryStatistics,并且此 OID 将返回网络适配器上所有接收队列的信息数组。

返回状态代码

NDIS 处理微型端口驱动程序OID_RECEIVE_FILTER_ENUM_QUEUES的 OID 查询请求,并返回以下状态代码之一。

状态代码 描述

NDIS_STATUS_SUCCESS

请求成功完成。 InformationBuffer 指向 NDIS_RECEIVE_QUEUE_INFO_ARRAY 结构。

NDIS_STATUS_PENDING

请求正在等待完成。 NDIS 将在请求完成后将最终状态代码和结果传递给调用方 OID 请求完成处理程序。

NDIS_STATUS_INVALID_LENGTH

信息缓冲区太短。 NDIS 设置 DATAMETHOD_INFORMATION。将 NDIS_OID_REQUEST 结构中的 BytesNeeded成员 到所需的最小缓冲区大小。

NDIS_STATUS_FAILURE

由于其他原因,请求失败。

要求

版本

NDIS 6.20 及更高版本中受支持。

页眉

Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_INFO

NDIS_RECEIVE_QUEUE_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS