Fungsi WdfRequestGetCompletionParams (wdfrequest.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Metode WdfRequestGetCompletionParams mengambil parameter penyelesaian I/O yang terkait dengan objek permintaan kerangka kerja tertentu.

Sintaks

void WdfRequestGetCompletionParams(
  [in]      WDFREQUEST                     Request,
  [in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);

Parameter

[in] Request

Handel ke objek permintaan kerangka kerja.

[in, out] Params

Penunjuk ke struktur WDF_REQUEST_COMPLETION_PARAMS yang disediakan penelepon.

Nilai kembali

Tidak ada

Keterangan

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

Setelah driver memanggil WdfRequestSend untuk mengirim permintaan I/O secara sinkron atau asinkron ke target I/O, dan setelah target I/O menyelesaikan permintaan I/O, driver dapat memanggil WdfRequestGetCompletionParams untuk mendapatkan parameter penyelesaian permintaan I/O.

Struktur parameter penyelesaian berisi informasi yang valid hanya jika driver telah memformat permintaan dengan memanggil salah satu metode WdfIoTargetFormatXxx . Misalnya, lihat WdfIoTargetFormatRequestForRead.

Perhatikan bahwa jika driver Anda memanggil salah satu metode yang mengirim permintaan I/O ke target I/O hanya secara sinkron (seperti WdfIoTargetSendReadSynchronously), driver tidak boleh memanggil WdfRequestGetCompletionParams.

Metode WdfRequestGetCompletionParams menyalin parameter penyelesaian permintaan I/O ke dalam struktur WDF_REQUEST_COMPLETION_PARAMS yang ditentukan.

Jika driver mengirim permintaan I/O secara asinkron, biasanya memanggil metode ini dari dalam fungsi panggilan balik CompletionRoutine .

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

Contoh

Contoh kode berikut menginisialisasi struktur WDF_REQUEST_COMPLETION_PARAMS lalu memanggil WdfRequestGetCompletionParams.

WDF_REQUEST_COMPLETION_PARAMS completionParams;

WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
                              request,
                              &completionParams
                              );

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)

Lihat juga

CompletionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT

Bagikan melalui