NDIS_PM_WAKE_PACKET结构（ntddndis.h）

项目
02/07/2025

NDIS_PM_WAKE_PACKET 结构描述导致网络适配器生成唤醒事件的网络数据包（称为 唤醒数据包）。

语法

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;

成员

Header

NDIS_PM_WAKE_PACKET 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将标头的类型成员设置为NDIS_OBJECT_TYPE_DEFAULT。若要指定 NDIS_PM_WAKE_PACKET 结构的版本，驱动程序必须将 Revision 成员标头设置为以下值：

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将大小成员设置为NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1。

Flags

一个 ULONG 值，该值包含标志的按位或。此成员保留为 NDIS。

PatternId

ULONG 值，该值指定与唤醒数据包匹配的 LAN 唤醒（WOL）模式的标识符。此标识符由 PatternIdNDIS_PM_WOL_PATTERN 结构的成员指定，该 NDIS_PM_WOL_PATTERN 结构在 OID_PM_ADD_WOL_PATTERN的 OID 集请求期间传递给驱动程序。

PatternFriendlyName

一个 NDIS_PM_COUNTED_STRING 值，该值包含由 PatternId 成员指定的唤醒模式的友好说明。此值由 FriendlyNameNDIS_PM_WOL_PATTERN 结构的成员指定，该 OID_PM_ADD_WOL_PATTERN的 OID 请求期间传递给驱动程序。

注意微型端口驱动程序不需要初始化此成员。 NDIS 将 PatternFriendlyName 成员设置为正确的值，然后再将 NDIS_PM_WAKE_PACKET 结构传递给过度分配的驱动程序。

OriginalPacketSize

ULONG 值，该值指定唤醒数据包的原始长度（以字节为单位）。

SavedPacketSize

ULONG 值，该值指定此结构后面的唤醒数据包数据的长度（以字节为单位）。

注意此成员的值至少应 min(wake packet size, 128) 字节。

SavedPacketOffset

ULONG 值，该值指定此结构后面的唤醒数据包数据的偏移量（以字节为单位）。偏移量从 NDIS_PM_WAKE_PACKET 结构的开头到包含唤醒数据包的缓冲区的开头。

注意保存的唤醒数据包的偏移量必须在 64 位边界上对齐。