Makro WdfDeviceStopIdleWithTag (wdfdevice.h)

  • Artikel

[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.

Sintaks

NTSTATUS WdfDeviceStopIdleWithTag(
    _In_ WDFDEVICE Device,
    _In_ BOOLEAN WaitForD0,
    _In_ PVOID Tag
);

Parameter

[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.

Mengembalikan nilai

Tidak ada

Keterangan

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

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

Lihat juga

Debugging Kebocoran Referensi Daya di WDF

WdfDeviceResumeIdle

WdfDeviceResumeIdleWithTag

WdfDeviceStopIdle