NetPowerOffloadListGetElement 函式 (netpoweroffloadlist.h)
NetPowerOffloadListGetElement 函式會從卸除清單取得低功率通訊協定卸除至網路適配器。
語法
NETPOWEROFFLOAD NetPowerOffloadListGetElement(
[_In_] const NET_POWER_OFFLOAD_LIST *List,
[_In_] SIZE_T Index
);
參數
[_In_] List
驅動程式配置和初始化 NET_POWER_OFFLOAD_LIST 結構的指標。
[_In_] Index
目標 NETPOWEROFFLOAD 物件清單中以零起始的索引。 此函式必須小於 NetPowerOffloadListGetCount所傳回的值。
傳回值
會傳回 NETPOWEROFFLOAD 物件,代表清單中指定索引處的低功率通訊協定卸除。
言論
呼叫 NetPowerOffloadListGetCount,以在呼叫此函式之前取得低功率通訊協定卸除的數目。
用戶端驅動程式只能在電源轉換期間呼叫 NetPowerOffloadListGetElement,通常是從其 EVT_WDF_DEVICE_ARM_WAKE_FROM_SX、EVT_WDF_DEVICE_ARM_WAKE_FROM_S0或 EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD 回呼函式。 否則,呼叫會產生系統錯誤檢查。
如需使用 NETPOWEROFFLOAD 物件的程式代碼範例,請參閱 設定電源管理。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 2004 |
目標平臺 | 普遍 |
最低 UMDF 版本 | 2.33 |
標頭 | netpoweroffloadlist.h (包括 netadaptercx.h) |
IRQL | PASSIVE_LEVEL |