共用方式為

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)
目標平台 Universal
最低UMDF版本 2.33
標頭 netpoweroffloadlist.h (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL

另請參閱

設定電源管理

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount