estrutura NDIS_RECEIVE_QUEUE_INFO (ntddndis.h)

Artigo
02/26/2024

A estrutura NDIS_RECEIVE_QUEUE_INFO contém informações sobre uma fila de recebimento em um adaptador de rede.

Sintaxe

typedef struct _NDIS_RECEIVE_QUEUE_INFO {
  NDIS_OBJECT_HEADER                   Header;
  ULONG                                Flags;
  NDIS_RECEIVE_QUEUE_TYPE              QueueType;
  NDIS_RECEIVE_QUEUE_ID                QueueId;
  NDIS_RECEIVE_QUEUE_GROUP_ID          QueueGroupId;
  NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE QueueState;
  GROUP_AFFINITY                       ProcessorAffinity;
  ULONG                                NumSuggestedReceiveBuffers;
  ULONG                                MSIXTableEntry;
  ULONG                                LookaheadSize;
  NDIS_VM_NAME                         VmName;
  NDIS_QUEUE_NAME                      QueueName;
  ULONG                                NumFilters;
  ULONG                                InterruptCoalescingDomainId;
} NDIS_RECEIVE_QUEUE_INFO, *PNDIS_RECEIVE_QUEUE_INFO;

Membros

Header

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

O driver de miniporta deve definir o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_RECEIVE_QUEUE_INFO , o driver deve definir o membro Revision do Header como um dos seguintes valores:

NDIS_RECEIVE_QUEUE_INFO_REVISION_2

Membros adicionais adicionados para o NDIS 6.30.

Nota A revisão 2 dessa estrutura tem suporte apenas em Windows Server 2012 e versões posteriores do Windows Server.

Defina o membro Size como NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_2.

NDIS_RECEIVE_QUEUE_INFO_REVISION_1

Versão original do NDIS 6.20.

Defina o membro Size como NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para NDIS.

QueueType

Um NDIS_RECEIVE_QUEUE_TYPE valor de enumeração que especifica o tipo da fila de recebimento.

QueueId

Um valor de tipo NDIS_RECEIVE_QUEUE_ID que contém um identificador de fila de recebimento. Esse identificador é um valor inteiro entre zero e o número de filas às quais o adaptador de rede dá suporte. Um valor de NDIS_DEFAULT_RECEIVE_QUEUE_ID especifica a fila de recebimento padrão.

QueueGroupId

Esse membro é reservado para NDIS.

QueueState

Um NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE valor de enumeração que especifica o estado operacional da fila de recebimento.

ProcessorAffinity

Um bitmap GROUP_AFFINITY que especifica a CPU com a qual a fila tem afinidade. Por exemplo, a configuração do bit 0 indica que a CPU 0 é usada, a configuração do bit 1 indica que a CPU 1 é usada e assim por diante. Como uma fila de VM está associada a uma CPU, todas as indicações de recebimento para a fila são tratadas nesse processador.

NumSuggestedReceiveBuffers

Um valor ULONG que contém um valor sugerido para o número de buffers de recebimento que o adaptador de rede deve usar para dar suporte à fila. Esse número pode ser ajustado em relação aos recursos que o driver de miniporto tem disponíveis ou proporcionalmente ao número que o adaptador de rede usa para outras filas. Por exemplo, o número real de buffers de recebimento pode ser o dobro ou metade desse valor sugerido.

MSIXTableEntry

Um valor ULONG que contém o índice de entrada da tabela MSI-X para a fila.

LookaheadSize

Um valor ULONG para o tamanho, em bytes, do requisito de tamanho lookahead para essa fila. Um adaptador de rede que dá suporte ao lookahead em filas de VM divide um pacote recebido em um deslocamento igual ou maior que o tamanho de lookahead solicitado e usa o AMD para transferir os dados lookahead e os dados pós-lookahead para segmentos de memória compartilhados separados.

Nota A partir do NDIS 6.30, não há mais suporte para a divisão de dados de pacote em buffers lookahead separados. O valor desse membro deve ser definido como zero.

VmName

Um valor NDIS_VM_NAME que contém a descrição amigável da máquina virtual.

QueueName

Um valor NDIS_QUEUE_NAME que contém a descrição amigável da fila.

NumFilters

Um valor ULONG que especifica o número de filtros de recebimento que foram configurados no adaptador de rede.

Nota A partir do NDIS 6.30, o driver de miniporto deve manter um contador para o número atual de filtros de recebimento definidos no adaptador de rede. O driver deve incrementar o contador sempre que um filtro de recebimento é definido por meio de uma solicitação de conjunto de OID de OID_RECEIVE_FILTER_SET_FILTER. O driver também deve diminuir o contador sempre que um filtro de recebimento é limpo por meio de uma solicitação de conjunto OID de OID_RECEIVE_FILTER_CLEAR_FILTER.

InterruptCoalescingDomainId

Um valor ULONG reservado para uso pelo NDIS. Esse valor é usado para fins informativos pelo driver de miniporta.

Comentários

A estrutura NDIS_RECEIVE_QUEUE_INFO é usada com o NDIS_RECEIVE_QUEUE_INFO_ARRAY estrutura para o OID_RECEIVE_FILTER_ENUM_QUEUES OID que enumera recebe filas em um adaptador de rede.

Com um retorno bem-sucedido do OID_RECEIVE_FILTER_ENUM_QUEUES, o NDIS fornece uma estrutura NDIS_RECEIVE_QUEUE_INFO_ARRAY que define as propriedades da matriz de fila de recebimento. Cada elemento na matriz é uma estrutura NDIS_RECEIVE_QUEUE_INFO .