estructura NDIS_NET_BUFFER_LIST_FILTERING_INFO (ndis.h)

Artículo
08/07/2023

La estructura NDIS_NET_BUFFER_LIST_FILTERING_INFO define la información de filtrado asociada a una estructura de NET_BUFFER_LIST .

Sintaxis

typedef struct _NDIS_NET_BUFFER_LIST_FILTERING_INFO {
  union {
    struct {
      USHORT FilterId;
      union {
        USHORT QueueId;
        USHORT VPortId;
      } QueueVPortInfo;
    } FilteringInfo;
    PVOID Value;
  };
} NDIS_NET_BUFFER_LIST_FILTERING_INFO, *PNDIS_NET_BUFFER_LIST_FILTERING_INFO;

Miembros

FilteringInfo

Estructura que contiene los siguientes miembros:

FilteringInfo.FilterId

Valor de USHORT que contiene un identificador de filtro de recepción. El identificador de filtro de recepción es un entero de uno al número de filtros de recepción que admite el adaptador de red.

Nota A partir de NDIS 6.20, este miembro debe establecerse en cero.

FilteringInfo.QueueVPortInfo

Unión que contiene los siguientes miembros:

FilteringInfo.QueueVPortInfo.QueueId

Valor de USHORT que contiene un identificador de una cola de máquinas virtuales (VMQ) de recepción. El identificador de cola 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 A partir de Windows Server 2012, el valor de este miembro siempre debe establecerse en NDIS_DEFAULT_RECEIVE_QUEUE_ID por los controladores de miniporte que admiten la interfaz SR-IOV.

FilteringInfo.QueueVPortInfo.VPortId

Valor de USHORT que contiene el identificador de un puerto virtual (VPort). Un valor de NDIS_DEFAULT_VPORT_ID especifica el VPort predeterminado en el conmutador NIC.

El VPort con el valor VPortId especificado debe haberse creado previamente a través de una solicitud establecida de OID_NIC_SWITCH_CREATE_VPORT.

Nota Para la interfaz VMQ, este miembro debe establecerse en NDIS_DEFAULT_VPORT_ID.

Value

Valor de tipo PVOID que está en una unión con el miembro FilteringInfo . Este miembro permite que un controlador acceda a toda la información de la estructura NDIS_NET_BUFFER_LIST_FILTERING_INFO como un valor PVOID.

Comentarios

A partir de NDIS 6.20, los controladores de minipuerto usan la estructura NDIS_NET_BUFFER_LIST_FILTERING_INFO para especificar información de filtro de recepción que acompaña a las estructuras de NET_BUFFER asociadas a una estructura NET_BUFFER_LIST .

Para acceder a la estructura de NDIS_NET_BUFFER_LIST_FILTERING_INFO desde los datos de NET_BUFFER_LIST OOB, un controlador NDIS llama a la macro NET_BUFFER_LIST_INFO y especifica el tipo de información NetBufferListFilteringInfo .

Para acceder directamente a los valores de identificador, use NET_BUFFER_LIST_RECEIVE_FILTER_ID, NET_BUFFER_LIST_RECEIVE_FILTER_VPORT_ID o NET_BUFFER_LIST_RECEIVE_QUEUE_ID macros.