Makro WdfDeviceStopIdleWithTag (wdfdevice.h)
[Berlaku untuk KMDF dan UMDF]
Makro WdfDeviceStopIdleWithTag menambah jumlah referensi daya untuk objek perangkat kerangka kerja tertentu dan menetapkan nama file dan nomor baris driver saat ini ke referensi. Makro juga menetapkan nilai tag ke referensi.
NTSTATUS WdfDeviceStopIdleWithTag(
_In_ WDFDEVICE Device,
_In_ BOOLEAN WaitForD0,
_In_ PVOID Tag
);
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] WaitForD0
Nilai Boolean yang menunjukkan kapan WdfDeviceStopIdleWithTag akan kembali. Jika TRUE, itu hanya kembali setelah perangkat yang ditentukan telah memasuki status daya perangkat D0. Jika FALSE, metode akan segera kembali.
[in] Tag
Nilai yang ditentukan driver yang disimpan kerangka kerja sebagai tag identifikasi untuk referensi daya.
Tidak ada
Jika operasi berhasil, WdfDeviceStopIdleWithTag mengembalikan STATUS_SUCCESS.
Nilai pengembalian tambahan meliputi:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_PENDING | Perangkat sedang dinyalakan secara asinkron. |
| STATUS_INVALID_DEVICE_STATE | Driver bukan pemilik kebijakan daya untuk perangkat. |
| STATUS_POWER_STATE_INVALID | Terjadi kegagalan perangkat dan perangkat tidak dapat memasuki status daya D0-nya. |
Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Jika driver Anda memanggil WdfDeviceStopIdleWithTag untuk menambah jumlah referensi, driver harus memanggil WdfDeviceResumeIdleWithTag untuk mengurangi hitungan.
Memanggil WdfDeviceStopIdleWithTag alih-alihWdfDeviceStopIdle menyediakan informasi tambahan (nilai tag, nomor baris, dan nama file) yang dapat Anda lihat di debugger Microsoft. WdfDeviceStopIdleWithTag menggunakan nomor baris dan nama file driver saat ini.
Anda dapat melihat nilai tag, nomor baris, dan nama file dengan menggunakan ekstensi debugger !wdftagtracker . Ekstensi debugger menampilkan nilai tag sebagai penunjuk dan serangkaian karakter.
Gunakan !wdfkd.wdfdevice dengan bendera verbose pada dan temukan tautan ke !wdftagtracker dalam output:
kd> !wdfdevice <handle> f
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1.15 |
| Versi UMDF minimum | 2.15 |
| Header | wdfdevice.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | Lihat bagian Keterangan. |
| Aturan kepatuhan DDI | DriverCreate, KmdfIrql, KmdfIrql2 |