Fungsi WdfRequestSetCompletionRoutine (wdfrequest.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfRequestSetCompletionRoutine mendaftarkan atau membatalkan pendaftaran rutinitas penyelesaian untuk objek permintaan kerangka kerja yang ditentukan.

Sintaks

void WdfRequestSetCompletionRoutine(
  [in]           WDFREQUEST                         Request,
  [in, optional] PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine,
  [in, optional] __drv_aliasesMem WDFCONTEXT        CompletionContext
);

Parameter

[in] Request

Handel ke objek permintaan kerangka kerja.

[in, optional] CompletionRoutine

Penunjuk ke fungsi panggilan balik CompletionRoutine , jika driver mendaftarkan rutinitas penyelesaian, atau NULL driver membatalkan pendaftaran rutinitas penyelesaian yang terdaftar sebelumnya.

[in, optional] CompletionContext

Penunjuk yang tidak ditagih ke informasi konteks yang ditentukan driver yang diteruskan kerangka kerja ke fungsi panggilan balik CompletionRoutine . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Jika driver Anda meneruskan permintaan I/O, tetapi jika Anda ingin driver Anda diberi tahu ketika driver tingkat bawah menyelesaikan permintaan, driver Anda dapat memberikan fungsi panggilan balik CompletionRoutine dan memanggil WdfRequestSetCompletionRoutine untuk mendaftarkan fungsi. Kerangka kerja memanggil fungsi panggilan balik setelah driver tingkat bawah menyelesaikan permintaan I/O.

Untuk informasi selengkapnya tentang WdfRequestSetCompletionRoutine, lihat Menyelesaikan Permintaan I/O.

Contoh

Untuk contoh kode yang menggunakan WdfRequestSetCompletionRoutine, lihat WdfRequestSend.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfrequest.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), ReqCompletionRoutine(kmdf)

Lihat juga

CompletionRoutine