Fungsi WdfDeviceGetDevicePowerState (wdfdevice.h)

[Hanya berlaku untuk KMDF]

Catatan

Fungsi ini hanya untuk penggunaan internal Microsoft.

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

Sintaks

WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Menampilkan nilai

WdfDeviceGetDevicePowerState mengembalikan enumerator berjenis WDF_DEVICE_POWER_STATE yang mengidentifikasi status komputer status 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 WdfDeviceGetDevicePowerState mengembalikan nilai yang bermakna hanya jika dipanggil dari dalam fungsi panggilan balik berikut:

• EvtDevicePrepareHardware

• EvtDeviceReleaseHardware

• EvtDeviceD0Entry

• EvtDeviceD0EntryPostInterruptsEnabled

• EvtDeviceD0Exit

• EvtDeviceD0ExitPreInterruptsDisabled

• EvtDeviceSelfManagedIoInit

• EvtDeviceSelfManagedIoSuspend

• EvtDeviceSelfManagedIoRestart

Contoh

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

WDF_DEVICE_POWER_STATE state;

state = WdfDeviceGetDevicePowerState(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

WdfDeviceGetDevicePowerPolicyState