NDIS_PM_WAKE_PACKET Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_PM_WAKE_PACKET-Struktur beschreibt ein Netzwerkpaket (das als Wake-Paketbezeichnet wird), das dazu führte, dass der Netzwerkadapter ein Wake-up-Ereignis generierte.

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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_PM_WAKE_PACKET Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_PM_WAKE_PACKET-Struktur anzugeben, muss der Treiber den Revision Member 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 Size Member auf NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1 fest.

Flags

Ein ULONG--Wert, der ein bitweises ODER- von Flags enthält. Dieses Mitglied ist für NDIS reserviert.

PatternId

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

PatternFriendlyName

Ein NDIS_PM_COUNTED_STRING Wert, der die anzeigefreundliche Beschreibung des Wake-Musters enthält, das durch das PatternId Member angegeben wird. Dieser Wert wird durch das FriendlyName Member der NDIS_PM_WOL_PATTERN Struktur angegeben, die während einer OID-Anforderung von OID_PM_ADD_WOL_PATTERNan den Treiber übergeben wird.

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

OriginalPacketSize

Ein ULONG- Wert, der die ursprüngliche Länge in Bytes des Wake-Pakets angibt.

SavedPacketSize

Ein ULONG--Wert, der die Länge der nach dieser Struktur folgenden Wake-Paketdaten in Bytes angibt.

Hinweis Der Wert dieses Elements sollte mindestens min(wake packet size, 128) Bytes enthalten.

SavedPacketOffset

Ein ULONG- Wert, der den Offset in Byteeinheiten angibt, an die Wake-Paketdaten, die dieser Struktur folgen. Der Offset wird vom Anfang der NDIS_PM_WAKE_PACKET Struktur bis zum Anfang eines Puffers gemessen, der das Wake-Paket enthält.

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

Bemerkungen

Die NDIS_PM_WAKE_PACKET Struktur wird in der NDIS_STATUS_PM_WAKE_REASON Statusanzeige verwendet. Weitere Informationen zum Ausgeben dieser Statusanzeige finden Sie unter Ausstellen von NDIS Wake Reason Status Indications.