Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El uso excesivo 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 del método OID, el miembro InformationBuffer de la estructura de NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_QUEUE_PARAMETERS.
El uso excesivo 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 sobresalto proporciona un puntero a una estructura NDIS_RECEIVE_QUEUE_PARAMETERS del InformationBuffer miembro de la estructura de NDIS_OID_REQUEST.
Observaciones
El uso excesivo 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 miniporte NDIS 6.20 y versiones posteriores. Sin embargo, la solicitud OID es obligatoria para los controladores de miniport que admiten la interfaz de cola de máquinas virtuales (VMQ).
Nota Solo el controlador que asignó 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 sobrecalado obtuvo el valor de entrada del identificador de cola de una solicitud OID del método 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 de NDIS_RECEIVE_QUEUE_PARAMETERS. Sin embargo, después de asignar la cola, el controlador que está sobreasignado no puede cambiar los parámetros de configuración que no tienen una marca de cambio correspondiente.
Códigos de estado de retorno
NDIS controla la solicitud de método OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para controladores de miniport y devuelve uno de los siguientes códigos de estado.
| Código de estado | 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 el DATA.METHOD_INFORMATION.miembro bytesNeeded de la estructura NDIS_OID_REQUEST con el 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 (include Ndis.h) |