NetWakeSourceListGetElement 函式 (netwakesourcelist.h)
NetWakeSourceListGetElement 函式會從網路適配器的喚醒來源清單中取得喚醒來源。
語法
NETWAKESOURCE NetWakeSourceListGetElement(
[_In_] const NET_WAKE_SOURCE_LIST *List,
[_In_] SIZE_T Index
);
參數
[_In_] List
驅動程式配置和初始化 NET_WAKE_SOURCE_LIST 結構的句柄。
[_In_] Index
目標 NETWAKESOURCE 物件清單中以零起始的索引。 此函式必須小於 NetWakeSourceListGetCount 所傳回的值。
傳回值
會傳回NETWAKESOURCE物件,此物件代表清單中的指定索引處的喚醒來源。
備註
呼叫 NetWakeSourceListGetCount 以在呼叫此函式之前取得喚醒來源的數目。
用戶端驅動程式必須在電源轉換期間呼叫 NetWakeSourceListGetElement ,通常是從其 EVT_WDF_DEVICE_ARM_WAKE_FROM_SX、 EVT_WDF_DEVICE_ARM_WAKE_FROM_S0或 EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE 回呼函式。 否則,呼叫會產生系統錯誤檢查。
如需使用 NETWAKESOURCE 物件的程式代碼範例,請參閱 設定電源管理。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 2004) |
目標平台 | Universal |
最低UMDF版本 | 2.33 |
標頭 | netwakesourcelist.h (包含 netadaptercx.h) |
程式庫 | netadaptercxstub.lib |
IRQL | PASSIVE_LEVEL |