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) |