OID_RECEIVE_FILTER_QUEUE_PARAMETERS
El exceso de controladores emite solicitudes de método de identificador de objeto (OID) de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para obtener los parámetros de configuración actuales de una cola de recepción. El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_QUEUE_PARAMETERS con un identificador de cola de tipo NDIS_RECEIVE_QUEUE_ID. Después de una devolución correcta de la solicitud de método OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_QUEUE_PARAMETERS .
El exceso de controladores emite solicitudes de conjunto de OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para cambiar los parámetros de configuración actuales de una cola. El controlador de sobreaprovisionamiento proporciona un puntero a una estructura de NDIS_RECEIVE_QUEUE_PARAMETERS en el miembro InformationBuffer de la estructura NDIS_OID_REQUEST .
Observaciones
El exceso de controladores emite solicitudes de conjunto de OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para cambiar los parámetros de una o varias colas de recepción. La solicitud de conjunto de OID es opcional para los controladores de minipuerto NDIS 6.20 y versiones posteriores. Sin embargo, la solicitud de OID es obligatoria para los controladores de minipuerto que admiten la interfaz de la cola de máquinas virtuales (VMQ).
Nota Solo el controlador de sobreasignación de la cola puede cambiar los parámetros de configuración mediante la emisión de solicitudes de conjunto de OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS.
El controlador de sobreaprovisionamiento obtuvo el valor de entrada del identificador de cola de una solicitud de OID del método de OID_RECEIVE_FILTER_ALLOCATE_QUEUE anterior.
Después de que el controlador sobreasigne una cola, puede cambiar los parámetros de configuración que tienen una marca de cambio correspondiente (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) en el miembro Flags de la estructura NDIS_RECEIVE_QUEUE_PARAMETERS . Sin embargo, una vez asignada la cola, el controlador de sobreasignación no puede cambiar los parámetros de configuración que no tienen una marca de cambio correspondiente.
Códigos de estado de devolución
NDIS controla la solicitud de método OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para controladores de minipuerto y devuelve uno de los siguientes códigos de estado.
| status code | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
La solicitud se completó correctamente. |
NDIS_STATUS_PENDING |
La solicitud está pendiente de finalización. NDIS pasará el código de estado final y los resultados al controlador de finalización de solicitudes OID del autor de la llamada una vez completada la solicitud. |
NDIS_STATUS_INVALID_LENGTH |
El búfer de información era demasiado corto. NDIS establece los DATOS. METHOD_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario. |
NDIS_STATUS_INVALID_PARAMETER |
Error en la solicitud porque intentó habilitar una funcionalidad que el adaptador de red subyacente no admite. |
NDIS_STATUS_FAILURE |
Error en la solicitud por otros motivos. |
Requisitos
Versión |
Se admite en NDIS 6.20 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |