EVT_WDF_DEVICE_QUERY_STOP fungsi panggilan balik (wdfdevice.h)
[Berlaku untuk KMDF dan UMDF]
Fungsi panggilan balik peristiwa EvtDeviceQueryStop driver menentukan apakah perangkat tertentu dapat dihentikan sehingga manajer PnP dapat mendistribusikan ulang sumber daya perangkat keras sistem.
Sintaks
EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;
NTSTATUS EvtWdfDeviceQueryStop(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
Nilai kembali
Jika driver menentukan bahwa perangkat dapat dihentikan, fungsi panggilan balik EvtDeviceQueryStop harus mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(statusnya) sama dengan TRUE. Jika tidak, itu harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE. Jangan kembali STATUS_NOT_SUPPORTED.
Keterangan
Untuk mendaftarkan fungsi panggilan balik EvtDeviceQueryStop , driver harus memanggil WdfDeviceInitSetPnpowerEventCallbacks.
Jika perangkat dan driver mendukung daya diam, perangkat mungkin tidak dalam keadaan berfungsi saat kerangka kerja memanggil fungsi panggilan balik EvtDeviceQueryStop driver. Fungsi panggilan balik dapat memanggil WdfDeviceStopIdle untuk memaksa perangkat ke status berfungsi (D0), lalu fungsi panggilan balik dapat memanggil WdfDeviceResumeIdle sebelum kembali.
Untuk informasi selengkapnya tentang fungsi panggilan balik EvtDeviceQueryStop , lihat Menangani Permintaan untuk Menghentikan Perangkat.
Kerangka kerja tidak menyinkronkan fungsi panggilan balik EvtDeviceQueryStop dengan fungsi panggilan balik PnP dan manajemen daya lainnya. Untuk informasi tentang bagaimana kerangka kerja menyinkronkan eksekusi fungsi panggilan balik peristiwa driver, lihat Menggunakan Sinkronisasi Otomatis.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Versi UMDF minimum | 2.0 |
| Header | wdfdevice.h (termasuk Wdf.h) |
| IRQL | PASSIVE_LEVEL |