Fungsi WdfDeviceInitSetPowerNotPageable (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDeviceInitSetPowerNotPageable memberi tahu manajer daya bahwa driver tidak akan mengakses data yang dapat di-pageable saat sistem bertransisi antara status tidur dan status kerja (S0).

Sintaks

void WdfDeviceInitSetPowerNotPageable(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parameter

[in] DeviceInit

Penunjuk yang disediakan penelepon ke struktur WDFDEVICE_INIT .

Nilai kembali

Tidak ada

Keterangan

Jika driver fungsi atau driver bus Anda memanggil WdfDeviceInitSetPowerNotPageable, perangkat file halaman sistem mungkin tidak dalam status berfungsi (D0) saat perangkat driver Anda memasuki status daya rendah atau kembali ke status kerjanya. Oleh karena itu, selama transisi daya perangkat Anda, driver Anda tidak boleh melakukan operasi apa pun yang dapat menyebabkan sistem operasi mengakses file halaman. Operasi tersebut termasuk mengakses file, registri, atau kumpulan halaman.

Secara default, kerangka kerja memungkinkan akses ke data yang dapat di-pageable untuk driver fungsi. Kerangka kerja menggunakan pengaturan perangkat induk untuk setiap perangkat anak yang dijumlahkan oleh driver bus, kecuali driver bus memanggil WdfDeviceInitSetPowerPageable atau WdfDeviceInitSetPowerNotPageable untuk perangkat anak. Jika Anda menulis driver bus yang memanggil WdfDeviceInitSetPowerPageable untuk perangkat anak, tidak ada driver di tumpukan perangkat anak yang dapat memanggil WdfDeviceInitSetPowerNotPageable.

Memanggil WdfDeviceInitSetPowerPageable atau WdfDeviceInitSetPowerNotPageable dari driver filter tidak berpengaruh. Kerangka kerja menggunakan pengaturan yang ditentukan driver berikutnya yang lebih rendah.

Sebagian besar driver tidak perlu memanggil WdfDeviceInitSetPowerPageable atau WdfDeviceInitSetPowerNotPageable. Sebagai gantinya, Anda harus membiarkan kerangka kerja menggunakan pengaturan default yang sesuai untuk driver Anda. Namun, driver Anda harus memanggil WdfDeviceInitSetPowerNotPageable jika driver adalah bagian dari tumpukan driver yang tidak boleh mengakses data yang dapat di-pageable selama transisi daya (seperti tumpukan penyimpanan atau tumpukan video), atau jika driver adalah driver bus yang menghitung perangkat yang mungkin merupakan perangkat penyimpanan atau video.

Jika driver Anda memanggil WdfDeviceInitSetPowerNotPageable, itu harus dilakukan sebelum memanggil WdfDeviceCreate.

Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Contoh

Contoh kode berikut memberi tahu manajer daya bahwa driver tidak akan mengakses data yang dapat dipaginasi saat sistem bertransisi antara status tidur dan status kerja (S0).

WdfDeviceInitSetPowerNotPageable(DeviceInit);

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 ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Lihat juga

WdfDeviceInitSetPowerPageable