EVT_WDF_DEVICE_QUERY_REMOVE fungsi panggilan balik (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtDeviceQueryRemove driver menentukan apakah perangkat tertentu dapat dihentikan dan dihapus.

Sintaks

EVT_WDF_DEVICE_QUERY_REMOVE EvtWdfDeviceQueryRemove;

NTSTATUS EvtWdfDeviceQueryRemove(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

Jika driver menentukan bahwa perangkat dapat dihentikan dan dihapus, fungsi panggilan balik EvtDeviceQueryRemove 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 EvtDeviceQueryRemove , driver harus memanggil WdfDeviceInitSetPnpowerEventCallbacks.

Jika perangkat dan driver mendukung daya diam, perangkat mungkin tidak dalam keadaan berfungsi saat kerangka kerja memanggil fungsi panggilan balik EvtDeviceQueryRemove 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 EvtDeviceQueryRemove , lihat Menangani Permintaan untuk Menghentikan Perangkat.

Kerangka kerja tidak menyinkronkan fungsi panggilan balik EvtDeviceQueryRemove 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

EvtDeviceQueryStop