OID_RECEIVE_FILTER_QUEUE_PARAMETERS

过度应用驱动程序发出OID_RECEIVE_FILTER_QUEUE_PARAMETERS的对象标识符(OID)方法请求以获取接收队列的当前配置参数。 NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向具有 NDIS_RECEIVE_QUEUE_ID类型的队列标识符的 NDIS_RECEIVE_QUEUE_PARAMETERS 结构的指针。 从 OID 方法请求成功返回后,InformationBufferNDIS_OID_REQUEST 结构的成员包含指向 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 集OID_RECEIVE_FILTER_QUEUE_PARAMETERS请求来更改配置参数。

过度分配的驱动程序从先前的 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 方法 OID 请求中获取了队列标识符输入值。

过度分配驱动程序分配队列后,它可以在 NDIS_RECEIVE_QUEUE_PARAMETERS 结构的 标志 成员中更改具有相应更改标志(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 设置 DATAMETHOD_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