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) |