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

Lihat juga

EvtDeviceQueryRemove