Compartir a través de

OID_RECEIVE_FILTER_ENUM_FILTERS

Un controlador demasiado excesivo emite una solicitud de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para obtener una lista de todos los filtros configurados en un adaptador de red.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_FILTER_INFO_ARRAY.

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 un búfer. Este búfer tiene el formato para contener lo siguiente:

  • Estructura NDIS_RECEIVE_FILTER_INFO_ARRAY que especifica una lista de filtros de recepción configurados actualmente en un controlador de miniport.

  • Matriz de estructuras de NDIS_RECEIVE_FILTER_INFO. Cada estructura especifica los parámetros de un filtro de recepción que está configurado actualmente en un controlador de miniport.

Observaciones

Los filtros de recepción NDIS se usan en las siguientes interfaces NDIS:

El uso excesivo de controladores o aplicaciones emite solicitudes de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para enumerar los filtros de recepción que se establecieron en un adaptador de red. Esto incluye filtros de recepción establecidos en un puerto virtual (VPort) SR-IOV o una cola de recepción de VMQ.

Instrucciones adicionales para la interfaz de fusión de paquetes NDIS

A partir de Windows Server 2012, la fusión de paquetes NDIS solo admite la cola de recepción predeterminada de un adaptador de red.

Para enumerar los filtros de recepción de fusión de paquetes, el controlador sobrepuesto debe establecer el QueueId miembro de la estructura de NDIS_RECEIVE_FILTER_INFO_ARRAY en NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Instrucciones adicionales para la interfaz de SR-IOV

A partir de Windows Server 2012, la interfaz SR-IOV solo admite la cola de recepción predeterminada de un puerto virtual (VPort).

Para enumerar los filtros de recepción de VPort, el controlador sobrepuesto debe establecer el QueueId miembro de la estructura de NDIS_RECEIVE_FILTER_INFO_ARRAY en NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Instrucciones adicionales para la interfaz VMQ

Un controlador sobrecalado puede emitir solicitudes de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para enumerar los filtros de recepción establecidos en una cola de recepción de VMQ. Cuando el controlador que está sobreatendiendo inicializa la estructura de NDIS_RECEIVE_FILTER_INFO_ARRAY, establece el queueId miembro en uno de los siguientes valores:

  • Valor de identificador de cola para una cola de recepción no predeterminada. El controlador sobrecalado obtuvo el valor de entrada del identificador de cola de una solicitud de método OID anterior de OID_RECEIVE_FILTER_ALLOCATE_QUEUE o una solicitud de consulta OID de OID_RECEIVE_FILTER_ENUM_QUEUES.

  • Valor de identificador de cola de NDIS_DEFAULT_RECEIVE_QUEUE_ID, que especifica la cola de recepción predeterminada.

Códigos de estado de retorno

NDIS controla la solicitud de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para controladores de miniport y devuelve uno de los siguientes códigos de estado:

NDIS_STATUS_SUCCESS
La solicitud se completó correctamente. El InformationBuffer apunta a una estructura NDIS_RECEIVE_FILTER_INFO_ARRAY.

NDIS_STATUS_PENDING
La solicitud está pendiente de finalización. NDIS pasa 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. QUERY_INFORMATION. BytesNeeded miembro 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 (include Ndis.h)

Consulte también

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_INFO

NDIS_RECEIVE_FILTER_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_ENUM_QUEUES

OID_RECEIVE_FILTER_SET_FILTER

  • Last updated on