Partilhar via


NET_POWER_OFFLOAD_NS_PARAMETERS estrutura (netpoweroffload.h)

A estrutura de NET_POWER_OFFLOAD_NS_PARAMETERS contém parâmetros para um descarregamento de protocolo de baixa potência do IPv6 Neighbor Solicitation (NS) 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 para esse descarregamento de protocolo.

RemoteIPv6Address

O campo de 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 de NA (anúncio vizinho) quando estiver em um estado de baixa potência. 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 da 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.

Nota

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.

Observações

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
de cliente com suporte mínimo Windows 10, versão 2004
versão mínima do UMDF 2.33
cabeçalho netpoweroffload.h (inclua netadaptercx.h)

Consulte também

Configurando de gerenciamento de energia

NET_POWER_OFFLOAD_NS_PARAMETERS_INIT

NetPowerOffloadGetNsParameters