OID_RECEIVE_FILTER_QUEUE_PARAMETERS

过分的驱动程序发出对象标识符 (OID) OID_RECEIVE_FILTER_QUEUE_PARAMETERS 的方法请求,以获取接收队列的当前配置参数。 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向具有NDIS_RECEIVE_QUEUE_ID类型的队列标识符的NDIS_RECEIVE_QUEUE_PARAMETERS结构的指针。 从 OID 方法请求成功返回后,NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向NDIS_RECEIVE_QUEUE_PARAMETERS结构的指针。

过分的驱动程序发出OID_RECEIVE_FILTER_QUEUE_PARAMETERS的 OID 集请求,以更改队列的当前配置参数。 覆盖驱动程序提供指向 NDIS_OID_REQUEST 结构的 InformationBuffer 成员中的 NDIS_RECEIVE_QUEUE_PARAMETERS 结构的指针。

注解

过分的驱动程序发出OID_RECEIVE_FILTER_QUEUE_PARAMETERS的 OID 集请求,以更改一个或多个接收队列的参数。 对于 NDIS 6.20 及更高版本的微型端口驱动程序,OID 集请求是可选的。 但是,对于支持虚拟机队列 (VMQ) 接口的微型端口驱动程序,OID 请求是必需的。

注意 只有分配了队列的过度驱动程序才能通过发出OID_RECEIVE_FILTER_QUEUE_PARAMETERS的 OID 集请求来更改配置参数。

覆盖驱动程序从较早的 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 方法 OID 请求中获取了队列标识符输入值。

在过度分配驱动程序分配队列后,它可以更改NDIS_RECEIVE_QUEUE_PARAMETERS结构的Flags 成员中具有相应更改标志 (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) 的配置参数。 但是,在分配队列后,过度分配的驱动程序无法更改没有相应更改标志的配置参数。

返回状态代码

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

状态代码 说明

NDIS_STATUS_SUCCESS

请求已成功完成。

NDIS_STATUS_PENDING

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

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_INVALID_PARAMETER

请求失败,因为它尝试启用基础网络适配器不支持的功能。

NDIS_STATUS_FAILURE

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

要求

版本

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

标头

Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_PARAMETERS

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS