NET_WAKE_SOURCE_LIST 構造体 (netwakesourcelist.h)

[アーティクル]
02/26/2024

NET_WAKE_SOURCE_LIST構造体は、ネットアダプターの Wake-on-LAN (WoL) ソースの一覧を表します。

構文

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

メンバー

Size

この構造体のサイズ (バイト単位)。

Reserved[4]

予約済み。クライアントドライバーは、この値を直接読み取ったり書き込んだりすることはできません。

注釈

NET_WAKE_SOURCE_LIST_INITを呼び出してこの構造体を初期化し、NetDeviceGetWakeSourceList を呼び出して、このネットアダプターからウェイクソースの一覧を取得します。リストを取得したら、この構造体で NetWakeSourceListGetCount を呼び出してウェイクソースを表す NETWAKESOURCE オブジェクトの数を取得し、オブジェクトをループ処理して NetWakeSourceListGetElement を呼び出して、それぞれを取得します。 NETWAKESOURCE オブジェクトを取得したら、 NetWakeSourceGetType を呼び出してそのウェイクソースの型を取得し、適切な関数を呼び出してウェイクソースのパラメーターを取得できるようにします。

クライアントドライバーは、電源切り替え中にのみウェイクソース関連の関数を呼び出す必要があります。通常は、 そのEVT_WDF_DEVICE_ARM_WAKE_FROM_SX、 EVT_WDF_DEVICE_ARM_WAKE_FROM_S0、または コールバック関数EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE 。それ以外の場合、呼び出しによってシステムバグチェックが行われます。

NETWAKESOURCE オブジェクトの操作のコードサンプルについては、「電源管理の構成」を参照してください。