NDIS_PM_WAKE_PACKET 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

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 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_PM_WAKE_PACKET構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1] に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

PatternId

ウェイクパケットに一致する wake-on-LAN (WOL) パターンの識別子を指定する ULONG 値。この識別子は、OID_PM_ADD_WOL_PATTERNの OID セット要求中にドライバーに渡されるNDIS_PM_WOL_PATTERN 構造体のPatternId メンバーによって指定されます。

PatternFriendlyName

PatternId メンバーによって指定されたウェイクパターンのわかりやすい説明を含むNDIS_PM_COUNTED_STRING値。この値は、OID_PM_ADD_WOL_PATTERNの OID 要求中にドライバーに渡されるNDIS_PM_WOL_PATTERN 構造体のFriendlyName メンバーによって指定されます。

メモミニポートドライバーは、このメンバーを初期化する必要はありません。 NDIS は、NDIS_PM_WAKE_PACKET構造体を基になるドライバーに渡す前に、PatternFriendlyName メンバーを正しい値に設定します。

OriginalPacketSize

ウェイクパケットの元の長さをバイト単位で指定する ULONG 値。

SavedPacketSize

この構造体に続くウェイクパケットデータの長さをバイト単位で指定する ULONG 値。

メモこのメンバーの値は、少なくとも min(wake packet size, 128) バイトである必要があります。

SavedPacketOffset

この構造体に続くウェイクパケットデータへのオフセットをバイト単位で指定する ULONG 値。オフセットは、 NDIS_PM_WAKE_PACKET 構造体の先頭から、ウェイクパケットを含むバッファーの先頭まで測定されます。

メモ保存されたウェイクパケットへのオフセットは、64 ビット境界に配置する必要があります。