Fungsi WdfDeviceIndicateWakeStatus (wdfdevice.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfDeviceIndicateWakeStatus menginformasikan kerangka kerja bahwa driver bus panggilan telah berhenti menunggu perangkat tertentu untuk memicu sinyal bangun di bus.

Sintaks

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] WaitWakeStatus

Nilai status NTSTATUS. Jika perangkat memicu sinyal bangun, pemanggil harus mengatur nilai ini ke STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(WaitWakeStatus) sama dengan TRUE. Jika perangkat tidak memicu sinyal bangun atau jika kesalahan terdeteksi, pemanggil harus memberikan nilai status yang NT_SUCCESS(WaitWakeStatus) sama dengan FALSE. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 WaitWakeStatus STATUS_PENDING atau STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST
 Tumpukan driver tidak disiapkan untuk menunggu perangkat memicu sinyal bangun.
STATUS_INVALID_DEVICE_STATE
 Driver panggilan tidak bertanggung jawab untuk menunggu perangkat memicu sinyal bangun.
 

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

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

Keterangan

Jika NT_SUCCESS(WaitWakeStatus) sama dengan TRUE, kerangka kerja akan memulihkan perangkat dan sistem ke status kerjanya. Jika NT_SUCCESS(WaitWakeStatus) sama dengan FALSE, perangkat dan sistem akan tetap dalam statusnya saat ini.

Untuk informasi selengkapnya tentang memanggil metode WdfDeviceIndicateWakeStatus , lihat Mendukung Sistem Wake-Up.

Contoh

Contoh kode berikut menginformasikan kerangka kerja bahwa perangkat yang ditentukan telah memicu sinyal bangun.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

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 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)