NDIS_PM_WAKE_PACKET 结构 (ntddndis.h)

项目
02/29/2024

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 结构。

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

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

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

将 Size 成员设置为 NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。此成员是为 NDIS 保留的。

PatternId

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

PatternFriendlyName

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

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

OriginalPacketSize

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

SavedPacketSize

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

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

SavedPacketOffset

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

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