Metode IWDFRemoteTarget::CloseForQueryRemove (wudfddi.h)

Artikel
03/05/2024

[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.]

Metode CloseForQueryRemove menutup target I/O jarak jauh karena sistem operasi mungkin memungkinkan perangkat dihapus.

Sintaks

HRESULT CloseForQueryRemove();

Mengembalikan nilai

Metode CloseForQueryRemove selalu mengembalikan S_OK.

Keterangan

Jika driver Anda menyediakan fungsi panggilan balik IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove , fungsi panggilan balik harus memanggil CloseForQueryRemove jika mengembalikan TRUE untuk menunjukkan bahwa perangkat dapat dihapus.

Metode CloseForQueryRemove menyelesaikan atau membatalkan semua permintaan I/O yang telah dikirim driver ke target I/O.

Setelah driver memanggil CloseForQueryRemove, driver tidak dapat mengirim permintaan I/O ke target I/O hingga memanggil IWDFRemoteTarget::Buka kembali.

Untuk informasi selengkapnya tentang metode CloseForQueryRemove , lihat Mengontrol Status Target I/O Umum di UMDF.

Contoh

Contoh kode berikut menunjukkan fungsi panggilan balik IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove yang memanggil CloseForQueryRemove.

BOOL
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetQueryRemove(
    __in IWDFRemoteTarget  *FxTarget
    )
{
    //
    // Here, do any driver-specific actions that your driver requires
    // to stop sending I/O requests to the I/O target.
    //
...
    //
    // Close the target.
    //
    FxTarget->CloseForQueryRemove();

    //
    // Return TRUE if you want to allow removal of the device.
    //
    return TRUE;
}

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)
DLL	WUDFx.dll

Lihat juga

IWDFRemoteTarget

IWDFRemoteTarget::Close

Bagikan melalui