Fungsi WdfDeviceAssignSxWakeSettings (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceAssignSxWakeSettings menyediakan informasi yang disediakan driver tentang kemampuan perangkat untuk memicu sinyal bangun sementara perangkat dan sistem dalam status daya rendah.

Sintaks

NTSTATUS WdfDeviceAssignSxWakeSettings(
  [in] WDFDEVICE                              Device,
  [in] PWDF_DEVICE_POWER_POLICY_WAKE_SETTINGS Settings
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] Settings

Penunjuk ke struktur WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS yang disediakan penelepon.

Nilai kembali

Jika operasi berhasil, WdfDeviceAssignSxWakeSettings mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Menampilkan kode Deskripsi
STATUS_INVALID_DEVICE_REQUEST
 Driver panggilan bukan pemilik kebijakan daya perangkat.
STATUS_INVALID_PARAMETER
 Nilai Pengaturan tidak valid terdeteksi.
STATUS_INFO_LENGTH_MISMATCH
 Ukuran struktur WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS salah.
STATUS_POWER_STATE_INVALID
 Driver bus menunjukkan perangkat tidak dapat memicu sinyal bangun, atau struktur WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS berisi status daya perangkat yang tidak valid.
 

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Untuk informasi selengkapnya, lihat Mendukung Wake-Up Sistem.

Contoh

Contoh kode berikut menginisialisasi struktur WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS lalu memanggil WdfDeviceAssignSxWakeSettings. Contohnya menggunakan pengaturan default yang WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT diatur.

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS  wakeSettings;
NTSTATUS  status = STATUS_SUCCESS;

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT(&wakeSettings);

status = WdfDeviceAssignSxWakeSettings(
                                       device,
                                       &wakeSettings
                                       );
if (!NT_SUCCESS(status)) {
    return status;
}

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdevice.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), FDOPowerPolicyOwnerAPI(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NonFDONotPowerPolicyOwnerAPI(kmdf)

Lihat juga

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS

WdfDeviceAssignS0IdleSettings