NET_POWER_OFFLOAD_NS_PARAMETERS-Struktur (netpoweroffload.h)

Artikel
05/23/2024

Die NET_POWER_OFFLOAD_NS_PARAMETERS-Struktur enthält Parameter für eine IPv6 Neighbor Solicitation (NS)-Protokollabladung mit geringer Energie an einen Netzadapter.

Syntax

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;

Member

Size

Die Größe dieser Struktur in Bytes.

Id

Der Bezeichner für diese Protokollauslagerung.

RemoteIPv6Address

Das Quelladressenfeld im IPv6-Header der NS-Nachricht. Dieses Member ist optional.

Wenn die eingehende NS-Nachricht über einen Quelladressenwert verfügt, der dieser IPv6-Adresse entspricht, sendet der Netzadapter eine Nachbarankündigungsnachricht (NA), wenn sie sich in einem Schwachstromzustand befindet. Wenn dieser Member 0 ist, sollte der Netzadapter auf NS-Nachrichten von jeder IPv6-Remoteadresse reagieren.

SolicitedNodeIPv6Address

Die angeforderte Knoten-IPv6-Adresse.

TargetIPv6Addresses[2]

Ein Array, das eine oder zwei IPv6-Adressen enthält. Wenn sie nur eine Adresse enthält, wird diese Adresse im ersten Element des Arrays gespeichert, und das zweite Element wird mit Nullen gefüllt.

Clienttreiber müssen alle Adressen im Array nutzen.

Diese Adressen stellen das Feld Zieladresse einer NS-Nachricht dar. Wenn eine dieser Adressen mit dem Feld Zieladresse einer eingehenden NS-Nachricht übereinstimmt, sendet der Netzadapter als Antwort eine NA-Nachricht.

LinkLayerAddress

Die MAC-Adresse (Media Access Control). Beim Senden der NA-Nachricht verwendet der Netzadapter diese Adresse für das TLLA-Feld (Target Link Layer Address) der NA-Nachricht.

Hinweis

Wenn er eine NA-Nachricht sendet, muss der Netzadapter immer diese MAC-Adresse im TLLA-Feld der NA-Nachricht verwenden. Es sollte jedoch die aktuelle MAC-Adresse des Netzadapters als Quelladresse im MAC-Header verwenden.

Hinweise

Rufen Sie NET_POWER_OFFLOAD_NS_PARAMETERS_INIT auf, um diese Struktur zu initialisieren, und füllen Sie das Feld Größe aus. Rufen Sie nach dem Aufrufen NET_POWER_OFFLOAD_NS_PARAMETERS_INITNetPowerOffloadGetNsParameters auf, um die verbleibenden Elemente der Struktur auszufüllen.

Weitere Informationen zu IPv6-NS- und NA-Nachrichten finden Sie unter RFC 4861.