Metode IWDFIoRequest::SetCompletionCallback (wudfddi.h)

  • Artikel

[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 SetCompletionCallback mendaftarkan antarmuka untuk metode OnCompletion yang harus dipanggil kerangka kerja saat permintaan I/O selesai.

Sintaks

void SetCompletionCallback(
  [in]           IRequestCallbackRequestCompletion *pCompletionCallback,
  [in, optional] void                              *pContext
);

Parameter

[in] pCompletionCallback

Penunjuk ke antarmuka IRequestCallbackRequestCompletion yang metode OnCompletion-nya memanggil kerangka kerja setelah permintaan I/O selesai. Dimulai dengan VERSI 1.9 UMDF, driver dapat menentukan NULL untuk membatalkan pendaftaran metode OnCompletion yang terdaftar sebelumnya.

[in, optional] pContext

Penunjuk ke buffer yang berisi informasi konteks yang terkait dengan penyelesaian permintaan. Kerangka kerja meneruskan informasi konteks ini dalam panggilan ke metode IRequestCallbackRequestCompletion::OnCompletion . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Tidak ada

Keterangan

Jika driver yang meneruskan permintaan I/O memerlukan pemberitahuan ketika driver tingkat bawah menyelesaikan permintaan, driver dapat memberikan rutinitas penyelesaian dan memanggil SetCompletionCallback untuk mendaftarkan antarmuka IRequestCallbackRequestCompletion untuk rutinitas penyelesaian. Kerangka kerja memanggil rutinitas penyelesaian setelah driver tingkat bawah menyelesaikan permintaan I/O.

Contoh

Untuk contoh kode tentang cara menggunakan metode SetCompletionCallback , lihat IWDFIoRequest::Send.

Persyaratan

Persyaratan Nilai
Akhir dukungan Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform Desktop
Versi UMDF minimum 1,5
Header wudfddi.h (termasuk Wudfddi.h)
DLL WUDFx.dll

Lihat juga

IRequestCallbackRequestCompletion

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest

IWDFIoRequest::Send