estrutura NET_POWER_OFFLOAD_NS_PARAMETERS (netpoweroffload.h)

A estrutura NET_POWER_OFFLOAD_NS_PARAMETERS contém parâmetros para um descarregamento de protocolo de baixa potência de solicitação de vizinho (NS) IPv6 para um adaptador de rede.

Sintaxe

typedef struct _NET_POWER_OFFLOAD_NS_PARAMETERS {
  ULONG                          Size;
  ULONG                          Id;
  NET_IPV6_ADDRESS               RemoteIPv6Address;
  NET_IPV6_ADDRESS               SolicitedNodeIPv6Address;
  NET_IPV6_ADDRESS               TargetIPv6Addresses[2];
  NET_ADAPTER_LINK_LAYER_ADDRESS LinkLayerAddress;
} NET_POWER_OFFLOAD_NS_PARAMETERS;

Membros

Size

O tamanho dessa estrutura, em bytes.

Id

O identificador desse descarregamento de protocolo.

RemoteIPv6Address

O campo endereço de origem no cabeçalho IPv6 da mensagem NS. Esse membro é opcional.

Se a mensagem NS de entrada tiver um valor de Endereço de Origem que corresponda a esse endereço IPv6, o adaptador de rede enviará uma mensagem NA (anúncio vizinho) quando estiver em um estado de baixa energia. Se esse membro for zero, o adaptador de rede deverá responder a mensagens NS de qualquer endereço IPv6 remoto.

SolicitedNodeIPv6Address

O endereço IPv6 do nó solicitado.

TargetIPv6Addresses[2]

Uma matriz que contém um ou dois endereços IPv6. Se ele contiver apenas um endereço, esse endereço será armazenado no primeiro elemento na matriz e o segundo elemento será preenchido com zeros.

Os drivers de cliente devem consumir todos os endereços na matriz.

Esses endereços representam o campo Endereço de Destino de uma mensagem NS. Se um desses endereços corresponder ao campo Endereço de Destino de uma mensagem NS de entrada, o adaptador de rede enviará uma mensagem NA em resposta.

LinkLayerAddress

O endereço MAC (controle de acesso à mídia). Quando ele envia a mensagem NA, o adaptador de rede usa esse endereço para o campo TLLA (endereço de camada de link de destino) da mensagem NA.

Observação

Quando ele envia uma mensagem NA, o adaptador de rede sempre deve usar esse endereço MAC no campo TLLA da mensagem NA. No entanto, ele deve usar o endereço MAC atual do adaptador de rede como o endereço de origem no cabeçalho MAC.

Comentários

Chame NET_POWER_OFFLOAD_NS_PARAMETERS_INIT para inicializar essa estrutura e preencher seu campo Tamanho . Depois de chamar NET_POWER_OFFLOAD_NS_PARAMETERS_INIT, chame NetPowerOffloadGetNsParameters para preencher os membros restantes da estrutura.

Para obter mais informações sobre mensagens IPv6 NS e NA, consulte RFC 4861.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 2004
Versão mínima do UMDF 2.33
Cabeçalho netpoweroffload.h (inclua netadaptercx.h)

Confira também

Configurando o gerenciamento de energia

NET_POWER_OFFLOAD_NS_PARAMETERS_INIT

NetPowerOffloadGetNsParameters