Fungsi WdfDevStateIsNP (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDevStateIsNP mengembalikan nilai Boolean yang menunjukkan apakah status daya atau status kebijakan daya tertentu adalah status yang tidak dapat di-halaman .

Sintaks

BOOLEAN WdfDevStateIsNP(
  [in] ULONG State
);

Parameter

[in] State

Enumerator jenis WDF_DEVICE_POWER_STATE atau enumerator dengan jenis WDF_DEVICE_POWER_POLICY_STATE.

Nilai kembali

Jika driver panggilan saat ini tidak dapat diakses, metode WdfDevStateIsNP mengembalikan TRUE. Jika tidak, metode mengembalikan FALSE.

Keterangan

Untuk mendapatkan status mesin status daya kerangka kerja saat ini, driver dapat memanggil WdfDeviceGetDevicePowerState dari dalam fungsi panggilan balik PnP atau daya. Untuk mendapatkan status komputer status kebijakan daya kerangka kerja saat ini, driver dapat memanggil WdfDeviceGetDevicePowerPolicyState dari dalam fungsi panggilan balik kebijakan daya. Setelah driver memanggil WdfDeviceGetDevicePowerState atau WdfDeviceGetDevicePowerPolicyState, ia dapat memanggil WdfDevStateIsNP untuk menentukan apakah status yang dikembalikan mewakili status yang dapat dipaginasi atau tidak dapat di-halaman. Jika mesin status kerangka kerja dalam keadaan tidak dapat di-halaman, driver tidak dapat di-pageable dan tidak boleh melakukan operasi apa pun yang dapat menyebabkan sistem operasi mengakses file halaman. Operasi tersebut termasuk mengakses file, registri, atau kumpulan halaman.

Contoh

Contoh kode berikut menetapkan nilai yang tidak dapat dihapus ke TRUE jika mesin status daya kerangka kerja saat ini dalam keadaan tidak dapat dihapus.

BOOLEAN nonpageable;

nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Tingkat apa pun

Lihat juga

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable