NDIS_PM_WAKE_PACKET 結構 (ntddndis.h)

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 值，指定符合喚醒封包之網路喚醒 (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位界限上對齊。

 

備註

NDIS_PM_WAKE_PACKET結構用於NDIS_STATUS_PM_WAKE_REASON狀態指示中。 如需如何發出此狀態指示的詳細資訊，請參閱 發出 NDIS 喚醒原因狀態指示。

規格需求

需求	值
最低支援的用戶端	NDIS 6.30 和更新版本支援。
標頭	ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_OBJECT_HEADER

NDIS_PM_COUNTED_STRING

NDIS_PM_WOL_PATTERN

NDIS_STATUS_PM_WAKE_REASON

OID_PM_ADD_WOL_PATTERN