fungsi WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wudfdevice.h)

Artikel
02/27/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Fungsi WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT menginisialisasi struktur WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS driver.

Sintaks

void WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
  [out] PWUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
  [in]  WDF_POWER_POLICY_S0_IDLE_CAPABILITIES   IdleCaps
);

Parameter

[out] Settings

Penunjuk ke struktur WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS yang dialokasikan driver.

[in] IdleCaps

Enumerator jenis WDF_POWER_POLICY_S0_IDLE_CAPABILITIES.

Nilai kembali

Tidak ada

Keterangan

Pertama, fungsi WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT nol struktur WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS yang ditentukan dan menetapkan anggota Ukuran struktur.

Kemudian, fungsi mengatur anggota IdleTimeout struktur ke IdleTimeoutDefaultValue, mengatur anggota UserControlOfIdleSettings ke IdleAllowUserControl, dan mengatur anggota Diaktifkan ke WdfUseDefault.

Selain itu, fungsi ini mengatur anggota PowerUpIdleDeviceOnSystemWake ke WdfUseDefault.

Fungsi kemudian mengatur anggota ExcludeD3Cold ke WdfUseDefault.

Selanjutnya, fungsi mengatur anggota IdleCaps struktur ke nilai yang ditentukan parameter IdleCaps .

Terakhir, jika parameter IdleCaps menentukan IdleUsbSelectiveSuspend atau IdleCanWakeFromS0, fungsi menetapkan anggota DxState ke PowerDeviceMaximum. Jika parameter IdleCaps menentukan IdleCannotWakeFromS0, fungsi mengatur anggota DxState ke PowerDeviceD3.

Untuk contoh kode yang menggunakan WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, lihat IWDFDevice3::AssignS0IdleSettingsEx.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1.11
Header	wudfdevice.h

Lihat juga

IWDFDevice3::AssignS0IdleSettingsEx

WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS

Bagikan melalui