estrutura NDIS_NET_BUFFER_LIST_FILTERING_INFO (ndis.h)

Artigo
02/26/2024

A estrutura NDIS_NET_BUFFER_LIST_FILTERING_INFO define informações de filtragem associadas a uma estrutura NET_BUFFER_LIST .

Sintaxe

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;

Membros

FilteringInfo

Uma estrutura que contém os seguintes membros:

FilteringInfo.FilterId

Um valor USHORT que contém um identificador de filtro de recebimento. O identificador de filtro de recebimento é um inteiro de um para o número de filtros de recebimento compatíveis com o adaptador de rede.

Nota A partir do NDIS 6.20, esse membro deve ser definido como zero.

FilteringInfo.QueueVPortInfo

Uma união que contém os seguintes membros:

FilteringInfo.QueueVPortInfo.QueueId

Um valor USHORT que contém um identificador para uma fila de recebimento de VMQ (fila de máquinas virtuais). O identificador de fila é um inteiro entre zero e o número de filas compatíveis com o adaptador de rede. Um valor de NDIS_DEFAULT_RECEIVE_QUEUE_ID especifica a fila de recebimento padrão.

Nota Começando com Windows Server 2012, o valor desse membro sempre deve ser definido como NDIS_DEFAULT_RECEIVE_QUEUE_ID por drivers de miniport que dão suporte à interface SR-IOV.

FilteringInfo.QueueVPortInfo.VPortId

Um valor USHORT que contém o identificador de uma porta virtual (VPort). Um valor de NDIS_DEFAULT_VPORT_ID especifica o VPort padrão na opção NIC.

O VPort com o valor VPortId especificado deve ter sido criado anteriormente por meio de uma solicitação definida de OID_NIC_SWITCH_CREATE_VPORT.

Nota Para a interface VMQ, esse membro deve ser definido como NDIS_DEFAULT_VPORT_ID.

Value

Um valor de tipo PVOID que está em uma união com o membro FilteringInfo . Esse membro permite que um driver acesse todas as informações na estrutura NDIS_NET_BUFFER_LIST_FILTERING_INFO como um valor PVOID.

Comentários

A partir do NDIS 6.20, os drivers de miniporto usam a estrutura NDIS_NET_BUFFER_LIST_FILTERING_INFO para especificar informações de filtro de recebimento que acompanham as estruturas de NET_BUFFER associadas a uma estrutura NET_BUFFER_LIST .

Para acessar a estrutura NDIS_NET_BUFFER_LIST_FILTERING_INFO dos dados OOB NET_BUFFER_LIST, um driver NDIS chama a macro NET_BUFFER_LIST_INFO e especifica o tipo de informação NetBufferListFilteringInfo .

Para acessar os valores do identificador diretamente, use o NET_BUFFER_LIST_RECEIVE_FILTER_ID, NET_BUFFER_LIST_RECEIVE_FILTER_VPORT_ID ou NET_BUFFER_LIST_RECEIVE_QUEUE_ID macros.