Compartilhar via

NDIS_RSS_SET_INDIRECTION_ENTRY estrutura (ntddndis.h)

  • Artigo

Aviso

Algumas informações neste tópico referem-se ao produto pré-relacionado, que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, em relação às informações fornecidas aqui.

O RSSv2 é visualizado apenas no Windows 10, versão 1803.

A estrutura NDIS_RSS_SET_INDIRECTION_ENTRY representa um comando para definir uma única entrada de tabela de indireção. Ele está contido em uma estrutura NDIS_RSS_SET_INDIRECTION_ENTRIES, que é usada na OID OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES. OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES é um OID síncrono para RSS Versão 2 (RSSv2).

Sintaxe

typedef struct _NDIS_RSS_SET_INDIRECTION_ENTRY {
  NDIS_NIC_SWITCH_ID       SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
  ULONG                    Flags;
  USHORT                   IndirectionTableIndex;
  PROCESSOR_NUMBER         TargetProcessorNumber;
  NDIS_STATUS              EntryStatus;
} NDIS_RSS_SET_INDIRECTION_ENTRY, *PNDIS_RSS_SET_INDIRECTION_ENTRY;

Membros

SwitchId

Um valor NDIS_NIC_SWITCH_ID que representa a opção NIC em que o VPort reside.

O identificador de comutador é um inteiro entre zero e o número de comutadores compatíveis com o adaptador de rede. Um valor NDIS_DEFAULT_SWITCH_ID indica o comutador de adaptador de rede padrão.

Esse campo deve ser definido como 0 no caso RSS nativo.

VPortId

Um valor NDIS_NIC_SWITCH_VPORT_ID que representa o identificador VPort.

Esse campo deve ser definido como 0 no caso RSS nativo.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro qualifica as informações nessa estrutura.

Os sinalizadores possíveis são os seguintes:

Valor Significado
NDIS_RSS_SET_INDIRECTION_ENTRY_FLAG_PRIMARY_PROCESSOR
 Indica que o NDIS_RSS_SET_INDIRECTION_ENTRY está se referindo ao processador primário da entidade de dimensionamento. A tabela de indireção não é usada. Quando o processador primário está *inativo* (o RSS está habilitado), o driver de miniporto deve acompanhar as atualizações das entradas com esse conjunto de sinalizadores para que ele saiba qual processador será o principal quando o RSS estiver desabilitado.
NDIS_RSS_SET_INDIRECTION_ENTRY_FLAG_DEFAULT_PROCESSOR
 Indica que o NDIS_RSS_SET_INDIRECTION_ENTRY está se referindo ao processador padrão da entidade de dimensionamento. O processador padrão lida com pacotes com unhed. A tabela de indireção não é usada. Quando o processador padrão é *inativo* (o RSS está desabilitado), o driver de miniporto deve acompanhar as atualizações de entradas com esse sinalizador definido para que ele saiba qual processador será padrão quando o RSS estiver habilitado.

IndirectionTableIndex

O índice de hash do ITE que atualmente aponta para a CPU atual e está sendo modificado para apontar para outro processador. Quando a tabela de indireção é inativa (o RSS está desabilitado), o driver de miniporto deve acompanhar as atualizações das entradas da tabela de indireção para que ela tenha a tabela de indireção correta quando o RSS estiver habilitado.

TargetProcessorNumber

O número do processador de destino para o qual o ITE deve apontar após a conclusão. O driver de miniporto deve ter êxito na movimentação do ITE do processador atual para o atual.

EntryStatus

Um código NDIS_STATUS indicando o status da operação de movimentação dessa entrada. Como NDIS_RSS_SET_INDIRECTION_ENTRY é usado no contexto de uma chamada OID síncrona, o driver de miniporto não pode retornar NDIS_STATUS_PENDING para esse membro.

Para simplificar a implementação dos drivers de miniporto, o protocolo de camada superior inicializará esse campo para NDIS_STATUS_PENDING. Os drivers de miniporto devem substituir NDIS_STATUS_PENDING com um código de status NDIS com êxito ou falha. Se a camada superior detectar que esse campo ainda está NDIS_STATUS_PENDING após a conclusão do OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES OID, isso causará uma verificação de bugs do sistema e indicará que o driver de miniporto está em falha.

Importante

Todas as estruturas NDIS_RSS_SET_INDIRECTION_ENTRY em um grupo, contidas em uma estrutura NDIS_RSS_SET_INDIRECTION_ENTRIES, devem ser marcadas com o mesmo EntryStatus.

Se ocorrer um erro com esse comando de movimentação, defina EntryStatus para um dos seguintes códigos de status para essa condição de erro:

Código de status Condição de erro
NDIS_STATUS_INVALID_PARAMETER
  • O SwitchId ou membro do VPortId era inválido.
  • O membro sinalizadores era inválido.
  • O membro IndirectionTableIndex excede o NumberOfIndirectionTableEntries atualmente configurado da estrutura NDIS_RECEIVE_SCALE_PARAMETERS_V2.
NDIS_STATUS_INVALID_PORT_STATE O VPort não está ativado ou está em algum outro estado que o impede de aceitar OIDs RSSv2.
NDIS_STATUS_NOT_ACCEPTED A CPU do ator era inválida.
NDIS_STATUS_INVALID_DATA Para um parâmetro de direção ativo, o novo processador não faz parte do conjunto de processadores RSS do adaptador. Observe que parâmetros de inativos só precisam ser rastreados. Eles são validados posteriormente, durante a transição de estado do RSS (para em ou fora).
NDIS_STATUS_NO_QUEUES Um grupo de entradas de comando falha na verificação "número de filas" para o VPort especificado por esse grupo.

Requisitos

Requisito Valor
de cliente com suporte mínimo Com suporte no NDIS 6.80 e posterior.
cabeçalho ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_RSS_SET_INDIRECTION_ENTRIES

OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES

rssv2 (dimensionamento lateral de recebimento versão 2)

interface de solicitação OID síncrona no NDIS 6.80