Fungsi WdfRequestGetInformation (wdfrequest.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfRequestGetInformation mengembalikan informasi status penyelesaian untuk permintaan I/O tertentu.

Sintaks

ULONG_PTR WdfRequestGetInformation(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Handel ke objek permintaan kerangka kerja.

Nilai kembali

WdfRequestGetInformation mengembalikan informasi yang ditetapkan driver tingkat bawah dengan memanggil WdfRequestSetInformation atau WdfRequestCompleteWithInformation.

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

Keterangan

Driver dapat memanggil WdfRequestSetInformation atau WdfRequestCompleteWithInformation untuk mengatur informasi status penyelesaian untuk permintaan I/O. Driver Anda dapat memanggil WdfRequestGetInformation setelah driver tingkat bawah menyelesaikan permintaan, untuk mendapatkan informasi status penyelesaian yang ditetapkan driver tingkat bawah.

Jika driver Anda memanggil WdfRequestGetInformation setelah memanggil WdfRequestComplete untuk menyelesaikan permintaan, WdfRequestGetInformation mengembalikan NULL.

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

Contoh

Contoh kode berikut mengirimkan permintaan I/O ke target I/O lalu mendapatkan informasi status yang disediakan target I/O.

ULONG_PTR  informationRetrieved = NULL;

status = WdfIoTargetSendWriteSynchronously(
                                           ioTarget,
                                           request,
                                           &outputMemoryDescriptor,
                                           NULL,
                                           NULL,
                                           &bytesWritten
                                           );
if (NT_SUCCESS(status)) {
    informationRetrieved = WdfRequestGetInformation(request);
}

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

WdfRequestCompleteWithInformation

WdfRequestSetInformation