次の方法で共有


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

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

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

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

Size メンバーをNDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1に設定します。

Flags

フラグのビットごとの または を含む 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 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 Wake Reason Status Indicationsを発行する」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント 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