Fungsi WdfDeviceInitRegisterPowerPolicyStateChangeCallback (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF saja]

Catatan

Metode ini hanya untuk penggunaan internal Microsoft.

Metode WdfDeviceInitRegisterPowerPolicyStateChangeCallback mendaftarkan fungsi panggilan balik peristiwa yang disediakan driver yang dipanggil kerangka kerja saat komputer status kebijakan daya perangkat berubah status.

Sintaks

NTSTATUS WdfDeviceInitRegisterPowerPolicyStateChangeCallback(
  [in] PWDFDEVICE_INIT                                       DeviceInit,
  [in] WDF_DEVICE_POWER_POLICY_STATE                         PowerPolicyState,
  [in] PFN_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION EvtDevicePowerPolicyStateChange,
  [in] ULONG                                                 CallbackTypes
);

Parameter

[in] DeviceInit

Penunjuk yang disediakan penelepon ke struktur WDFDEVICE_INIT .

[in] PowerPolicyState

Enumerator WDF_DEVICE_POWER_POLICY_STATE yang mengidentifikasi status komputer kebijakan daya tempat driver meminta pemberitahuan.

[in] EvtDevicePowerPolicyStateChange

Penunjuk yang disediakan penelepon ke fungsi panggilan balik peristiwa EvtDevicePowerPolicyStateChange driver.

[in] CallbackTypes

Kombinasi ORed dari enumerator jenis WDF_STATE_NOTIFICATION_TYPE.

Nilai kembali

Jika WdfDeviceInitRegisterPowerPolicyStateChangeCallback tidak mengalami kesalahan, WdfDeviceInitRegisterPowerPolicyStateChangeCallback tidak mengalami kesalahan, maka akan mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 Parameter yang tidak valid terdeteksi.
STATUS_INSUFFICIENT_RESOURCES
 Memori tidak cukup untuk menyelesaikan operasi.

Keterangan

Jika driver Anda memanggil WdfDeviceInitRegisterPowerPolicyStateChangeCallback, itu harus melakukannya sebelum memanggil WdfDeviceCreate.

Untuk informasi selengkapnya tentang WdfDeviceInitRegisterPowerPolicyStateChangeCallback, lihat State Machines dalam Kerangka Kerja.

Contoh

Contoh kode berikut mendaftarkan fungsi panggilan balik peristiwa yang akan dipanggil kerangka kerja saat komputer status kebijakan daya perangkat berubah status.

status = WdfDeviceInitRegisterPowerPolicyStateChangeCallback(
                                 DeviceInit,
                                 WdfDevStatePwrPolCheckPowerPageable,
                                 PciDrvPowerPolicyStateChangeCallback,
                                 StateNotificationAllStates
                                 );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)