Fungsi WdfRequestSetCompletionRoutine (wdfrequest.h)

[Berlaku untuk KMDF dan UMDF]

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

Sintaksis

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 didaftarkan sebelumnya.

[in, optional] CompletionContext

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

Mengembalikan nilai

Tidak

Komentar

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 menyediakan fungsi panggilan balik CompletionRoutine dan memanggil WdfRequestSetCompletionRoutine untuk mendaftarkan fungsi. Kerangka kerja memanggil fungsi panggilan balik setelah driver tingkat bawah menyelesaikan permintaan I/O.

Jika driver menetapkan panggilan balik penyelesaian I/O, driver harus memformat permintaan sebelum mengirimkannya ke target I/O default meskipun driver tidak mengubah parameter apa pun dalam permintaan. Pemformatan dapat dilakukan menggunakan WdfRequestFormatRequestUsingCurrentType.

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

Contoh

Untuk contoh kode yang menggunakan WdfRequestSetCompletionRoutine, lihat WdfRequestSend.

Persyaratan

Syarat	Nilai
Platform Target	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