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