NDIS_RECEIVE_QUEUE_INFO estrutura (ntddndis.h)

Artigo
02/07/2025

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 miniporto deve definir o membro tipo do de cabeçalho para NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_RECEIVE_QUEUE_INFO, o driver deve definir o membro de Revisão do de Cabeçalho para um dos seguintes valores:

NDIS_RECEIVE_QUEUE_INFO_REVISION_2

Membros adicionais adicionados para o NDIS 6.30.

Observação Revisão 2 dessa estrutura só tem suporte no Windows Server 2012 e versões posteriores do Windows Server.

Defina o membro tamanho como NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_2.

NDIS_RECEIVE_QUEUE_INFO_REVISION_1

Versão original do NDIS 6.20.

Defina o membro tamanho do como NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_1.

Flags

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

QueueType

Um valor de enumeração NDIS_RECEIVE_QUEUE_TYPE 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 que o adaptador de rede dá suporte. Um valor de NDIS_DEFAULT_RECEIVE_QUEUE_ID especifica a fila de recebimento padrão.

QueueGroupId

Este membro é reservado para NDIS.

QueueState

Um valor de enumeração NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE 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 ULONG valor 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 de ULONG que contém o índice de entrada da tabela MSI-X para a fila.

LookaheadSize

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

Observação Começando com o 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.

Observação Começando com o 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 for definido por meio de uma solicitação de conjunto de OID de OID_RECEIVE_FILTER_SET_FILTER. O driver também deve decrementar o contador sempre que um filtro de recebimento for limpo por meio de uma solicitação de conjunto de 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 miniporto.

Observações

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 receber 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.