NET_WAKE_SOURCE_LIST結構 (netwakesourcelist.h)

NET_WAKE_SOURCE_LIST 結構代表網路卡的喚醒 (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 物件的程式代碼範例，請參閱設定電源管理。