IWDFRemoteTarget::Buka kembali metode (wudfddi.h)

Artikel
03/01/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 Buka kembali membuka kembali target I/O jarak jauh setelah ditutup sementara.

Sintaks

HRESULT Reopen();

Mengembalikan nilai

Buka kembali S_OK jika operasi berhasil. Jika tidak, metode mungkin mengembalikan nilai berikut:

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Upaya kerangka kerja untuk mengalokasikan memori gagal.

Metode ini mungkin mengembalikan salah satu nilai lain yang dikandung Winerror.h.

Pemverifikasi kerangka kerja melaporkan kesalahan jika kerangka kerja tidak dapat membuka file.

Keterangan

Biasanya, driver memanggil Buka kembali dari dalam fungsi panggilan balik IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled , tetapi Buka kembali dapat dipanggil setelah onRemoteTargetRemoveCanceled kembali.

Buka kembali menggunakan nama file atau antarmuka yang sebelumnya ditentukan driver ke IWDFRemoteTarget::OpenFileByName atau IWDFRemoteTarget::OpenRemoteInterface. Jika Anda ingin mengubah file atau antarmuka yang digunakan driver, driver dapat memanggil IWDFRemoteTarget::Close, dan kemudian dapat memanggil OpenFileByName atau OpenRemoteInterface alih-alih Buka kembali.

Untuk informasi selengkapnya tentang Membuka kembali dan cara menggunakan target I/O jarak jauh di driver berbasis UMDF, lihat Mengontrol Status Target I/O Umum di UMDF.

Contoh

Contoh kode berikut menunjukkan fungsi panggilan balik IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled yang memanggil Buka Kembali.

VOID 
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveCanceled(
    __in IWDFRemoteTarget* FxTarget
    )
{
 if (S_OK == (FxTarget->Reopen()))
    {
    //
    // Resume sending I/O requests to the remote target.
    //
    ...
    }
 else
    {
       FxTarget->Close();
    }
}

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