estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY especifica uma lista de filtros de recebimento configurados atualmente em um driver de miniporte.

Os filtros de recebimento do NDIS são usados nas seguintes interfaces NDIS:

Agrupamento de pacotes NDIS. Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Gerenciando filtros de recebimento de agrupamento de pacotes.
Virtualização de E/S de Raiz Única (SR-IOV). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Configurando um filtro de recebimento em uma porta virtual.
VMQ (Fila de Máquinas Virtuais). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Configuração e limpeza de filtros VMQ.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O driver de miniporte deve definir o membro Tipo de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY , o driver deve definir o membro Revision de Header como o seguinte valor:

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

Membros adicionados para o NDIS 6.30.

Defina o membro Size como NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2.

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

Versão original do NDIS 6.20.

Defina o membro Size como NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1.

QueueId

Um identificador de fila de recebimento. Esse identificador é 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 Os drivers de miniport que dão suporte à união de pacotes NDIS ou à interface SR-IOV devem definir o membro QueueId como NDIS_DEFAULT_RECEIVE_QUEUE_ID.

FirstElementOffset

O deslocamento, em bytes, para o primeiro elemento em uma matriz de elementos que seguem essa estrutura. O deslocamento é medido desde o início da estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY até o início do primeiro elemento. Cada elemento na matriz é uma estrutura NDIS_RECEIVE_FILTER_INFO .

Nota Se NumElements estiver definido como zero, esse membro será ignorado.

NumElements

O número de elementos na matriz.

ElementSize

O tamanho, em bytes, de cada elemento da matriz.

Flags

Um OR bit a bit dos seguintes sinalizadores:

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

Se esse sinalizador estiver definido, serão solicitadas informações sobre filtros de recebimento configurados na porta virtual (VPort) especificada pelo membro VPortId .

Nota Esse sinalizador só é válido para a interface SR-IOV.

VPortId

O identificador de porta virtual (VPort) no qual os filtros de recebimento estão sendo consultados. O identificador VPort deve ser um dos seguintes valores:

O identificador de um VPort que foi alocado anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.
Um valor de NDIS_DEFAULT_VPORT_ID que especifica o VPort padrão na opção NIC.

Um comutador NIC é compatível com adaptadores de rede para a interface SR-IOV. A opção NIC pode ser configurada para ter uma ou mais VPorts.

Nota O membro VPortId só será válido se o sinalizador NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED estiver definido em Sinalizadores.

Comentários

A estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY é usada na solicitação OID de OID_RECEIVE_FILTER_ENUM_FILTERS. Essa solicitação OID enumera os filtros de recebimento em uma fila de recebimento de VMQ ou SR-IOV. Cada elemento na matriz que segue a estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY é um NDIS_RECEIVE_FILTER_INFO estrutura.