IWDFIoRequest2::Gunakan kembali metode (wudfddi.h)

[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 Penggunaan kembali menginisialisasi ulang objek permintaan kerangka kerja sehingga dapat digunakan kembali.

Sintaks

void Reuse(
  [in] HRESULT hrNewStatus
);

Parameter

[in] hrNewStatus

Nilai status berjenis HRESULT yang ditetapkan kerangka kerja ke permintaan.

Nilai kembali

Tidak ada

Keterangan

Jika driver berbasis kerangka kerja memanggil IWDFDevice::CreateRequest untuk membuat objek permintaan, driver dapat menggunakan kembali objek permintaan tersebut. Driver juga dapat menggunakan kembali objek permintaan yang mereka terima dari kerangka kerja dalam antrean I/O mereka.

Driver dapat menggunakan kembali objek permintaan setelah permintaan asli selesai. Setelah driver memanggil Gunakan Kembali, konten permintaan harus diinisialisasi ulang.

Jika Anda ingin permintaan yang digunakan kembali memiliki fungsi panggilan balik IRequestCallbackRequestCompletion::OnCompletion , driver harus memanggil IWDFIoRequest::SetCompletionCallback setelah memanggil Gunakan Kembali.

Untuk informasi selengkapnya tentang Penggunaan Kembali, lihat Menggunakan Kembali Objek Permintaan Kerangka Kerja.

Contoh

Contoh kode berikut menunjukkan bagaimana fungsi panggilan balik IRequestCallbackRequestCompletion::OnCompletion dapat memperoleh antarmuka IWDFIoRequest2 lalu memanggil Gunakan Kembali.

void 
STDMETHODCALLTYPE
CMyRemoteDevice::OnCompletion(
    __in IWDFIoRequest*  FxRequest,
    __in IWDFIoTarget*  FxTarget,
    __in IWDFRequestCompletionParams*  Params,
    __in void*  Context
    )
{
...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->Reuse(S_OK);
...
}

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

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest2

IWDFIoRequest::SetCompletionCallback