OID_RECEIVE_FILTER_ENUM_QUEUES
Los controladores excesivos y las aplicaciones en modo de usuario emiten solicitudes de consulta de identificador de objeto (OID) de OID_RECEIVE_FILTER_ENUM_QUEUES para obtener una lista de todas las colas de recepción que se asignan en un adaptador de red.
Después de una devolución correcta de la solicitud de consulta OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_QUEUE_INFO_ARRAY seguida de una estructura de NDIS_RECEIVE_QUEUE_INFO para cada filtro.
Observaciones
NDIS obtuvo la información de una caché interna de los datos que recibió de la OID_RECEIVE_FILTER_ALLOCATE_QUEUE y OID_RECEIVE_FILTER_QUEUE_PARAMETERS solicitudes de OID.
Los controladores excesivos y las aplicaciones en modo de usuario emiten solicitudes de consulta de OID de OID_RECEIVE_FILTER_ENUM_QUEUES para enumerar las colas de recepción en un adaptador de red.
Si un controlador de protocolo emite la solicitud, el tipo de solicitud dentro de la estructura de NDIS_OID_REQUEST se establece en NdisRequestQueryInformation y este OID devuelve una matriz de todas las colas de recepción que el controlador de protocolo asignó en el adaptador de red. Si una aplicación en modo de usuario emitió la solicitud, el tipo de solicitud dentro de la estructura de NDIS_OID_REQUEST se establece en NdisRequestQueryStatistics y este OID devuelve una matriz de información para todas las colas de recepción en el adaptador de red.
Códigos de estado de devolución
NDIS controla la solicitud de consulta OID de OID_RECEIVE_FILTER_ENUM_QUEUES 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. InformationBuffer apunta a una estructura de NDIS_RECEIVE_QUEUE_INFO_ARRAY. |
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_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) |