EVT_WDF_IO_TARGET_QUERY_REMOVE fungsi panggilan balik (wdfiotarget.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtIoTargetQueryRemove driver menunjukkan apakah kerangka kerja dapat menghapus perangkat target I/O jarak jauh tertentu dengan aman.

Sintaks

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

NTSTATUS EvtWdfIoTargetQueryRemove(
  [in] WDFIOTARGET IoTarget
)
{...}

Parameter

[in] IoTarget

Handel ke objek target I/O.

Nilai kembali

Fungsi panggilan balikEvtIoTargetQueryRemove harus mengembalikan STATUS_SUCCESS jika driver menentukan bahwa kerangka kerja dapat dengan aman menghapus perangkat target I/O yang ditentukan. Jika tidak, fungsi panggilan balik ini harus mengembalikan STATUS_UNSUCCESSFUL.

Keterangan

Jika fungsi panggilan balik EvtIoTargetQueryRemove driver mengembalikan STATUS_SUCCESS, sistem memungkinkan perangkat target I/O dihapus, kecuali driver lain mengembalikan STATUS_UNSUCCESSFUL.

Untuk mendaftarkan fungsi panggilan balik EvtIoTargetQueryRemove , tempatkan alamat fungsi panggilan balik di struktur WDF_IO_TARGET_OPEN_PARAMS target I/O. Fungsi panggilan balik EvtIoTargetQueryRemove bersifat opsional. Tidak menyediakan fungsi panggilan balik ini setara dengan mengembalikan STATUS_SUCCESS.

Fungsi panggilan balik EvtIoTargetQueryRemove harus memanggil WdfIoTargetCloseForQueryRemove, jika driver menentukan bahwa manajer PnP dapat dengan aman menghapus perangkat target.

Fungsi panggilan balik harus menonaktifkan kemampuan driver untuk mengirim permintaan I/O tambahan ke target I/O.

Untuk informasi selengkapnya tentang fungsi panggilan balik EvtIoTargetQueryRemove , lihat Mengontrol Status Target I/O Umum.