Fungsi WdfDeviceInitSetPowerPageable (wdfdevice.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfDeviceInitSetPowerPageable memberi tahu manajer daya bahwa driver harus dapat mengakses data yang dapat di-pageable saat sistem beralih antara status tidur dan status kerja (S0).

Sintaks

void WdfDeviceInitSetPowerPageable(
  [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 WdfDeviceInitSetPowerPageable, sistem memastikan bahwa perangkat file halaman dalam status berfungsi (D0) saat perangkat driver Anda memasuki status daya rendah atau kembali ke status kerjanya. Ini memungkinkan driver Anda untuk mengakses file, registri, dan kumpulan halaman selama transisi daya perangkat Anda.

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 WdfDeviceInitSetPowerInrush, driver tidak boleh memanggil WdfDeviceInitSetPowerPageable.

Driver Anda harus memanggil WdfDeviceInitSetPowerPageable 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 harus dapat mengakses data yang dapat dipaginasi saat sistem bertransisi antara status tidur dan status kerja (S0).

WdfDeviceInitSetPowerPageable(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

WdfDeviceInitSetPowerNotPageable