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 |