Fungsi WdfDeviceIndicateWakeStatus (wdfdevice.h)
[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 |
---|---|
|
WaitWakeStatus STATUS_PENDING atau STATUS_CANCELLED. |
|
Tumpukan driver tidak disiapkan untuk menunggu perangkat memicu sinyal bangun. |
|
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) |