EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE fungsi panggilan balik (wdfdevice.h)
[Hanya berlaku untuk KMDF]
Fungsi panggilan balik EvtDeviceWdmPostPoFxRegisterDevice melakukan operasi khusus perangkat setelah kerangka kerja terdaftar dengan kerangka kerja daya.
Sintaks
EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;
NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
[in] WDFDEVICE Device,
[in] POHANDLE PoHandle
)
{...}
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] PoHandle
Handel yang mewakili pendaftaran perangkat dengan kerangka kerja daya.
Nilai kembali
Nilai NTSTATUS yang menunjukkan keberhasilan atau kegagalan operasi yang dilakukan dalam panggilan balik ini. Jika kegagalan dikembalikan, kerangka kerja pada gilirannya akan gagal IRP_MN_START_DEVICE.
Keterangan
Jika Anda menulis driver KMDF untuk perangkat komponen tunggal yang menentukan beberapa status daya fungsional, Anda dapat mendaftarkan fungsi panggilan balik EvtDeviceWdmPostPoFxRegisterDevice untuk menerima pemberitahuan setelah kerangka kerja mendaftar dengan kerangka kerja manajemen daya (PoFx).
Untuk mendaftarkan EvtDeviceWdmPostPoFxRegisterDevice, driver harus memanggil WdfDeviceWdmAssignPowerFrameworkSettings.
POHANDLE yang diterima di EvtDeviceWdmPostPoFxRegisterDevice tetap valid sampai driver kembali dari EvtDeviceWdmPrePoFxUnregisterDevice.
Driver Anda dapat menggunakan POHANDLE untuk memanggil PoFxSetComponentLatency, PoFxSetComponentResidency, dan PoFxSetComponentWake untuk menentukan latensi, residensi, dan petunjuk bangun ke kerangka kerja daya.
Driver Anda juga dapat menggunakan POHANDLE untuk memanggil PoFxPowerControl untuk mengirim permintaan kontrol daya ke PoFx.
Driver KMDF untuk beberapa perangkat komponen tidak menyediakan EvtDeviceWdmPostPoFxRegisterDevice. Sebaliknya, driver seperti itu menerima POHANDLE ketika memanggil PoFxRegisterDevice. Untuk informasi selengkapnya, lihat Mendukung Beberapa Status Daya Fungsi untuk Perangkat Multiple-Component.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1.11 |
| Header | wdfdevice.h (termasuk Wdf.h) |
| IRQL | PASSIVE_LEVEL |