Fungsi WdfDeviceGetDevicePowerPolicyState (wdfdevice.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Catatan

Fungsi ini hanya untuk penggunaan internal Microsoft.

Metode WdfDeviceGetDevicePowerPolicyState mengembalikan status komputer status kebijakan daya kerangka kerja saat ini, untuk perangkat tertentu.

Sintaks

WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Menampilkan nilai

WdfDeviceGetDevicePowerPolicyState mengembalikan enumerator jenis WDF_DEVICE_POWER_POLICY_STATE yang mengidentifikasi status komputer status kebijakan daya kerangka kerja saat ini untuk perangkat yang ditentukan.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Untuk informasi selengkapnya tentang komputer status kerangka kerja, lihat State Machines dalam Kerangka Kerja.

Metode WdfDeviceGetDevicePowerPolicyState mengembalikan nilai yang bermakna hanya jika dipanggil dari dalam fungsi panggilan balik yang didaftarkan driver saat memanggil WdfDeviceInitSetPowerPolicyEventCallbacks.

Contoh

Contoh kode berikut mendapatkan status komputer status kebijakan daya kerangka kerja saat ini untuk perangkat tertentu.

WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;

devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);

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 <= DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerState