Fungsi NetPowerOffloadListGetElement (netpoweroffloadlist.h)

Fungsi NetPowerOffloadListGetElement mendapatkan offload protokol daya rendah dari daftar offload ke adaptor bersih.

Sintaks

NETPOWEROFFLOAD NetPowerOffloadListGetElement(
  [_In_] const NET_POWER_OFFLOAD_LIST *List,
  [_In_] SIZE_T                       Index
);

Parameter

[_In_] List

Penunjuk ke struktur NET_POWER_OFFLOAD_LIST yang dialokasikan driver dan diinisialisasi.

[_In_] Index

Indeks berbasis nol dalam daftar untuk objek NETPOWEROFFLOAD target. Fungsi ini harus kurang dari nilai yang dikembalikan oleh NetPowerOffloadListGetCount.

Mengembalikan nilai

Mengembalikan objek NETPOWEROFFLOAD, yang mewakili offload protokol daya rendah, pada indeks yang ditentukan dalam daftar.

Keterangan

Panggil NetPowerOffloadListGetCount untuk mendapatkan jumlah offload protokol daya rendah sebelum memanggil fungsi ini.

Driver klien hanya boleh memanggil NetPowerOffloadListGetElement selama transisi daya, biasanya dari fungsi panggilan balik EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0, atau EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD . Jika tidak, panggilan akan menghasilkan pemeriksaan bug sistem.

Untuk sampel kode bekerja dengan objek NETPOWEROFFLOAD, lihat Mengonfigurasi manajemen daya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, version 2004
Target Platform	Universal
Versi UMDF minimum	2.33
Header	netpoweroffloadlist.h (sertakan netadaptercx.h)
IRQL	PASSIVE_LEVEL

Lihat juga

Mengonfigurasi manajemen daya

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount