Metode IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (wudfddi.h)

Artikel
08/08/2023

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Fungsi panggilan balik peristiwa OnRemoteTargetQueryRemove driver berbasis UMDF menentukan apakah perangkat target I/O jarak jauh dapat dihentikan dan dihapus.

Sintaks

BOOL OnRemoteTargetQueryRemove(
  [in] IWDFRemoteTarget *pWdfRemoteTarget
);

Parameter

[in] pWdfRemoteTarget

Penunjuk ke antarmuka IWDFRemoteTarget dari objek target jarak jauh yang mewakili target I/O jarak jauh. Driver mendapatkan pointer ini ketika memanggil IWDFDevice2::CreateRemoteTarget.

Nilai kembali

Jika driver menentukan bahwa perangkat dapat dihentikan dan dihapus, fungsi panggilan balik peristiwa OnRemoteTargetQueryRemove harus mengembalikan TRUE. Jika tidak, fungsi panggilan balik harus mengembalikan FALSE.

Keterangan

Jika driver Anda menyediakan fungsi panggilan balik peristiwa OnRemoteTargetQueryRemove , fungsi panggilan balik harus menentukan apakah sistem operasi harus mengizinkan penghapusan perangkat. Jika driver menentukan bahwa perangkat dapat dihapus, itu harus melakukan hal berikut:

Lakukan tindakan khusus driver apa pun yang diperlukan untuk menghentikan I/O ke target jarak jauh.
Panggil IWDFRemoteTarget::CloseForQueryRemove.
Kembalikan TRUE untuk menunjukkan bahwa penghapusan dapat terjadi.

Jika driver menentukan bahwa perangkat tidak boleh dihapus, fungsi panggilan balik harus mengembalikan FALSE. Biasanya, driver harus menghindari pengembalian FALSE, karena nilai pengembalian FALSE dapat menyebabkan Windows dimulai ulang.

Jika driver tidak menyediakan fungsi panggilan balik ini, kerangka kerja memanggil IWDFRemoteTarget::CloseForQueryRemove untuk driver. Dengan kata lain, kerangka kerja selalu memungkinkan perangkat dihapus kecuali driver menyediakan fungsi panggilan balik peristiwa OnRemoteTargetQueryRemove .

Untuk informasi selengkapnya tentang fungsi panggilan balik peristiwa OnRemoteTargetQueryRemove , lihat Mengontrol Status Target I/O Umum di UMDF.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1.9
Header	wudfddi.h (termasuk Wudfddi.h)

Lihat juga

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete

Bagikan melalui