WdfRequestGetInformation-Funktion (wdfrequest.h)

[Gilt für KMDF und UMDF]

Die WdfRequestGetInformation-Methode gibt die Vervollständigung status Informationen für eine angegebene E/A-Anforderung zurück.

Syntax

ULONG_PTR WdfRequestGetInformation(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

Rückgabewert

WdfRequestGetInformation gibt die Informationen zurück, die ein Treiber auf niedrigerer Ebene durch Aufrufen von WdfRequestSetInformation oder WdfRequestCompleteWithInformation festgelegt hat.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Ein Treiber kann WdfRequestSetInformation oder WdfRequestCompleteWithInformation aufrufen, um die Vervollständigung status Informationen für eine E/A-Anforderung festzulegen. Ihr Treiber kann WdfRequestGetInformation aufrufen, nachdem ein Treiber auf niedrigerer Ebene eine Anforderung abgeschlossen hat, um den Abschluss status Informationen zu erhalten, die der Treiber auf niedrigerer Ebene festgelegt hat.

Wenn Ihr Treiber WdfRequestGetInformation aufruft, nachdem er WdfRequestComplete aufgerufen hat , um die Anforderung abzuschließen, gibt WdfRequestGetInformationNULL zurück.

Weitere Informationen zu WdfRequestGetInformation finden Sie unter Abschließen von E/A-Anforderungen.

Beispiele

Das folgende Codebeispiel sendet eine E/A-Anforderung an ein E/A-Ziel und ruft dann status Informationen ab, die das E/A-Ziel bereitgestellt hat.

ULONG_PTR  informationRetrieved = NULL;

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfrequest.h (include Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfRequestCompleteWithInformation

WdfRequestSetInformation