EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD fungsi panggilan balik (netdevice.h)

  • Artikel

Terapkan panggilan balik opsional ini untuk menolak offload protokol yang tidak kompatibel dengan perangkat keras Anda.

Sintaks

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

NTSTATUS EvtNetDevicePreviewPowerOffload(
  [_In_] WDFDEVICE Device,
  [_In_] NETPOWEROFFLOAD PowerOffload
)
{...}

Parameter

[_In_] Device

Objek WDFDEVICE yang sebelumnya diperoleh driver klien dengan panggilan ke WdfDeviceCreate.

[_In_] PowerOffload

Objek NETPOWEROFFLOAD yang mewakili offload protokol daya rendah untuk diperiksa.

Nilai kembali

Untuk menerima offload protokol, fungsi panggilan balik harus mengembalikan STATUS_SUCCESS.

Untuk menolak offload protokol, kembalikan STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL.

Keterangan

Driver tidak diperlukan untuk mengimplementasikan EvtNetDevicePreviewPowerOffload, karena NetAdapterCx sudah memblokir offload protokol yang tidak kompatibel dengan kemampuan offload daya driver: NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES dan NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES. Namun, jika perangkat keras Anda memiliki batasan tambahan yang tidak dapat dinyatakan dalam struktur kemampuan ini, Anda dapat menyediakan EvtNetDevicePreviewPowerOffload untuk menegakkan batasan tambahan tersebut.

Daftarkan implementasi fungsi panggilan balik ini dengan mengatur anggota NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS yang sesuai, lalu panggil NetDeviceInitSetPowerPolicyEventCallbacks.

Driver klien biasanya memanggil NetDeviceInitSetPowerPolicyEventCallbacks saat membuat objek perangkat, sebelum memanggil WdfDeviceCreate.

Dalam panggilan balik ini, driver klien mendapatkan kesempatan untuk menolak offload protokol. Misalnya, jika jumlah offload protokol dalam daftar offload protokol saat ini untuk Perangkat telah mencapai atau melebihi jumlah offload protokol yang didukung perangkat keras, driver dapat menolak offload protokol ini.

Untuk informasi selengkapnya, lihat Mengonfigurasi Power Management.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, version 2004
Header netdevice.h (termasuk netadaptercx.h)
IRQL PASSIVE_LEVEL