NDIS_PM_WAKE_PACKET-Struktur (ntddndis.h)

Artikel
03/01/2024

Die NDIS_PM_WAKE_PACKET-Struktur beschreibt ein Netzwerkpaket (bekannt als Aktivierungspaket), das dazu geführt hat, dass der Netzwerkadapter ein Aktivierungsereignis generiert.

Syntax

typedef struct _NDIS_PM_WAKE_PACKET {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  ULONG                  PatternId;
  NDIS_PM_COUNTED_STRING PatternFriendlyName;
  ULONG                  OriginalPacketSize;
  ULONG                  SavedPacketSize;
  ULONG                  SavedPacketOffset;
} NDIS_PM_WAKE_PACKET, *PNDIS_PM_WAKE_PACKET;

Member

Header

Typ, Revision und Größe der NDIS_PM_WAKE_PACKET-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_PM_WAKE_PACKET-Struktur anzugeben, muss der Treiber den Revisionsmember von Header auf den folgenden Wert festlegen:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1 fest.

Flags

Ein ULONG-Wert , der ein bitweises OR von Flags enthält. Dieser Member ist für NDIS reserviert.

PatternId

Ein ULONG-Wert , der den Bezeichner des Wake-on-LAN-Musters (WOL) angibt, das mit dem Aktivierungspaket übereinstimmt. Dieser Bezeichner wird durch den PatternId-Member der NDIS_PM_WOL_PATTERN-Struktur angegeben, die während einer OID-Satzanforderung von OID_PM_ADD_WOL_PATTERN an den Treiber übergeben wird.

PatternFriendlyName

Ein NDIS_PM_COUNTED_STRING Wert, der die benutzerfreundliche Beschreibung des Aktivierungsmusters enthält, das vom PatternId-Element angegeben wird. Dieser Wert wird vom FriendlyName-Member der NDIS_PM_WOL_PATTERN-Struktur angegeben, die während einer OID-Anforderung von OID_PM_ADD_WOL_PATTERN an den Treiber übergeben wird.

Hinweis Der Miniporttreiber muss diesen Member nicht initialisieren. NDIS legt das PatternFriendlyName-Element auf den richtigen Wert fest, bevor die NDIS_PM_WAKE_PACKET-Struktur an übergeordnete Treiber übergeben wird.

OriginalPacketSize

Ein ULONG-Wert , der die ursprüngliche Länge des Aktivierungspakets in Byteeinheiten angibt.

SavedPacketSize

Ein ULONG-Wert , der die Länge der Aktivierungspaketdaten in Byteeinheiten angibt, die dieser Struktur folgen.

Hinweis Der Wert dieses Members sollte mindestens min(wake packet size, 128) Byte aufweisen.

SavedPacketOffset

Ein ULONG-Wert , der den Offset in Byteeinheiten für die Aktivierungspaketdaten angibt, die dieser Struktur folgen. Der Offset wird vom Anfang der NDIS_PM_WAKE_PACKET-Struktur bis zum Anfang eines Puffers gemessen, der das Aktivierungspaket enthält.

Hinweis Der Offset zum gespeicherten Aktivierungspaket muss an einer 64-Bit-Grenze ausgerichtet werden.

Hinweise

Die NDIS_PM_WAKE_PACKET-Struktur wird in der NDIS_STATUS_PM_WAKE_REASON status-Angabe verwendet. Weitere Informationen zum Ausgeben dieser status-Angabe finden Sie unter Ausstellen von NDIS-Wake Reason StatusAnzeigen.