estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY (ntddndis.h)
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.
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 .
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 .
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.
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.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Com suporte no NDIS 6.20 e posterior. |
Cabeçalho | ntddndis.h (inclua Ndis.h) |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de