Kontrol Pengguna Atas Perilaku Menganggur dan Bangun Perangkat

Jika perangkat memiliki kemampuan matikan atau bangun diam, Anda dapat memutuskan apakah pengguna harus diizinkan untuk mengaktifkan atau menonaktifkan kemampuan ini.

Driver Anda dapat menggunakan anggota struktur WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS untuk menentukan apakah pengguna dengan akses registri dapat mengaktifkan atau menonaktifkan kemampuan daya diam perangkat.

Driver Anda dapat menggunakan anggota struktur WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS untuk menentukan apakah pengguna dengan akses registri dapat mengaktifkan atau menonaktifkan kemampuan bangun perangkat.

Kedua struktur ini memungkinkan driver untuk mengaktifkan kemampuan, menonaktifkan kemampuan, atau memberi pengguna kontrol kemampuan. Untuk memberi pengguna kontrol, dalam struktur pengaturan yang sesuai driver mengatur anggota UserControlOfIdleSettings atau UserControlOfWakeSettings ke IdleAllowUserControl atau WakeAllowUserControl, masing-masing, dan anggota Yang Diaktifkan ke WdfTrue atau WdfUseDefault,.

Jika driver Anda memungkinkan pengguna untuk memodifikasi pengaturan diam dan bangun, kerangka kerja menyediakan antarmuka pengguna, dalam bentuk halaman lembar properti yang ditampilkan Manajer Perangkat sehingga pengguna dapat mengaktifkan atau menonaktifkan kemampuan menganggur dan bangun. (Kerangka kerja memodifikasi nilai registri IdleInWorkingState dan WakeFromSleepState . Driver dan file penginstalannya tidak boleh membaca atau mengubah nilai-nilai ini.)

Jika pengguna memodifikasi pengaturan perangkat, kerangka kerja memperbarui status daya perangkat agar sesuai dengan pengaturan baru, jika perlu. Misalnya, jika pengguna menonaktifkan kemampuan daya diam perangkat saat perangkat sudah dalam status daya rendah karena tidak aktif, kerangka kerja mengembalikan perangkat ke status kerjanya.

Jika driver Anda memungkinkan pengguna untuk mengubah pengaturan diam dan bangun, kerangka kerja mengaktifkan pengaturan ini secara default. Beberapa penulis driver mungkin awalnya ingin menonaktifkan pengaturan sebelum mengizinkan pengguna mengubahnya.

Oleh karena itu, untuk KMDF versi 1.9 dan yang lebih baru, kerangka kerja menyediakan dua nilai registri yang dapat ditentukan driver, bernama WdfDefaultIdleInWorkingState dan WdfDefaultWakeFromSleepState, yang disimpan dalam perangkat Parameter Perangkat\kunci WDF , di bawah kunci perangkat keras perangkat. Nilainya REG_DWORD-ketik, dengan "0" yang menunjukkan kemampuan dinonaktifkan dan "1" menunjukkan kemampuan diaktifkan.

File INF driver Anda dapat menggunakan arahan INF AddReg untuk membuat dan mengatur nilai registri WdfDefaultIdleInWorkingState dan WdfDefaultWakeFromSleepState . Misalnya, jika driver Anda mengaktifkan kemampuan daya diam perangkat, tetapi jika kemampuan harus dinonaktifkan saat perangkat diinstal, file INF driver dapat mengatur WdfDefaultIdleInWorkingState ke "0".

Kerangka kerja memeriksa nilai registri WdfDefaultIdleInWorkingState dan WdfDefaultWakeFromSleepState hanya jika driver telah mengatur anggota UserControlOfIdleSettings atau UserControlOfWakeSettings ke IdleAllowUserControl atau WakeAllowUserControl, masing-masing, dan anggota yang diaktifkan ke WdfTrue atau WdfUseDefault, dalam struktur pengaturan yang sesuai.