OID_RECEIVE_FILTER_ENUM_QUEUES
过度分配驱动程序和用户模式应用程序发出对象标识符 (OID) 查询OID_RECEIVE_FILTER_ENUM_QUEUES的请求,以获取网络适配器上分配的所有接收队列的列表。
成功从 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_RECEIVE_FILTER_ENUM_QUEUES的 OID 查询请求,以枚举网络适配器上的接收队列。
如果协议驱动程序发出请求, 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 设置数据。METHOD_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。 |
NDIS_STATUS_FAILURE |
请求因其他原因而失败。 |
要求
版本 |
在 NDIS 6.20 及更高版本中受支持。 |
标头 |
Ntddndis.h (包括 Ndis.h) |