estructura NDIS_RECEIVE_FILTER_INFO_ARRAY (ntddndis.h)

Artículo
02/26/2024

La estructura NDIS_RECEIVE_FILTER_INFO_ARRAY especifica una lista de filtros de recepción configurados actualmente en un controlador de miniport.

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

Fusión de paquetes NDIS. Para obtener más información sobre cómo usar filtros de recepción en esta interfaz, consulte Administración de filtros de recepción de fusión de paquetes.
Virtualización de E/S raíz única (SR-IOV). Para obtener más información sobre cómo usar filtros de recepción en esta interfaz, vea Establecer un filtro de recepción en un puerto virtual.
Virtual Machine Queue (VMQ). Para obtener más información sobre cómo usar filtros de recepción en esta interfaz, consulte Configuración y borrado de filtros de VMQ.

Sintaxis

typedef struct _NDIS_RECEIVE_FILTER_INFO_ARRAY {
  NDIS_OBJECT_HEADER       Header;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  ULONG                    FirstElementOffset;
  ULONG                    NumElements;
  ULONG                    ElementSize;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_RECEIVE_FILTER_INFO_ARRAY, *PNDIS_RECEIVE_FILTER_INFO_ARRAY;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_RECEIVE_FILTER_INFO_ARRAY . Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_RECEIVE_FILTER_INFO_ARRAY , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

Se han agregado miembros para NDIS 6.30.

Establezca el miembro Size en NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2.

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

Versión original de NDIS 6.20.

Establezca el miembro Size en NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1.

QueueId

Identificador de cola de recepción. Este identificador es un entero entre cero y el número de colas que admite el adaptador de red. Un valor de NDIS_DEFAULT_RECEIVE_QUEUE_ID especifica la cola de recepción predeterminada.

Nota Los controladores de miniporte que admiten la fusión de paquetes NDIS o la interfaz SR-IOV deben establecer el miembro QueueId en NDIS_DEFAULT_RECEIVE_QUEUE_ID.

FirstElementOffset

Desplazamiento, en bytes, al primer elemento de una matriz de elementos que siguen esta estructura. El desplazamiento se mide desde el principio de la estructura NDIS_RECEIVE_FILTER_INFO_ARRAY hasta el principio del primer elemento. Cada elemento de la matriz es una estructura NDIS_RECEIVE_FILTER_INFO .

Nota Si NumElements se establece en cero, se omite este miembro.

NumElements

Número de elementos de la matriz.

ElementSize

Tamaño en bytes de cada elemento de la matriz.

Flags

Or bit a bit de las marcas siguientes:

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

Si se establece esta marca, se solicita información sobre los filtros de recepción configurados en el puerto virtual (VPort) especificado por el miembro VPortId .

Nota Esta marca solo es válida para la interfaz SR-IOV.

VPortId

Identificador de puerto virtual (VPort) en el que se consultan los filtros de recepción. El identificador VPort debe ser uno de los siguientes valores:

Identificador de un VPort que se asignó anteriormente a través de una solicitud de método OID de OID_NIC_SWITCH_CREATE_VPORT.
Valor de NDIS_DEFAULT_VPORT_ID que especifica el VPort predeterminado en el conmutador NIC.

Un conmutador NIC es compatible con adaptadores de red para la interfaz SR-IOV. El conmutador NIC se puede configurar para que tenga una o varias VPorts.

Nota El miembro VPortId solo es válido si la marca NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED está establecida en Flags.

Comentarios

La estructura NDIS_RECEIVE_FILTER_INFO_ARRAY se usa en la solicitud OID de OID_RECEIVE_FILTER_ENUM_FILTERS. Esta solicitud de OID enumera los filtros de recepción en una cola de recepción de VMQ o SR-IOV. Cada elemento de la matriz que sigue a la estructura NDIS_RECEIVE_FILTER_INFO_ARRAY es un NDIS_RECEIVE_FILTER_INFO estructura.