fungsi WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT menginisialisasi struktur WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS driver.

Sintaks

void WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
  [out] PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
  [in]  WDF_POWER_POLICY_S0_IDLE_CAPABILITIES  IdleCaps
);

Parameter

[out] Settings

Penunjuk ke struktur WDF_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 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT nol struktur WDF_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 dan anggota IdleTimeoutType ke DriverManagedIdleTimeout.

Selain itu, fungsi 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.

Contoh

Untuk contoh kode yang menggunakan WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, lihat WdfDeviceAssignS0IdleSettings.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)

Lihat juga

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS