WdfRequestGetInformation-Funktion (wdfrequest.h)
[Gilt für KMDF und UMDF]
Die WdfRequestGetInformation Methode gibt Abschlussstatusinformationen für eine angegebene E/A-Anforderung zurück.
Syntax
ULONG_PTR WdfRequestGetInformation(
[in] WDFREQUEST Request
);
Parameter
[in] Request
Ein Handle zu einem Framework-Anforderungsobjekt.
Rückgabewert
WdfRequestGetInformation die Informationen zurück, die ein niedrigerer Treiber durch Aufrufen WdfRequestSetInformation oder WdfRequestCompleteWithInformationfestgelegt wird.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Ein Treiber kann WdfRequestSetInformation oder WdfRequestCompleteWithInformation- aufrufen, um Abschlussstatusinformationen für eine E/A-Anforderung festzulegen. Ihr Treiber kann WdfRequestGetInformation aufrufen, nachdem ein Treiber auf niedrigerer Ebene eine Anforderung abgeschlossen hat, um Abschlussstatusinformationen zu erhalten, die der Treiber auf niedrigerer Ebene festgelegt hat.
Wenn ihr Treiber WdfRequestGetInformation aufruft, nachdem er WdfRequestComplete aufruft, um die Anforderung abzuschließen, gibt WdfRequestGetInformationNULL-zurück.
Weitere Informationen zu WdfRequestGetInformationfinden Sie unter Ausfüllen von E/A-Anforderungen.
Beispiele
Im folgenden Codebeispiel wird eine E/A-Anforderung an ein E/A-Ziel gesendet und anschließend Statusinformationen abgerufen, die vom E/A-Ziel bereitgestellt werden.
ULONG_PTR informationRetrieved = NULL;
status = WdfIoTargetSendWriteSynchronously(
ioTarget,
request,
&outputMemoryDescriptor,
NULL,
NULL,
&bytesWritten
);
if (NT_SUCCESS(status)) {
informationRetrieved = WdfRequestGetInformation(request);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfrequest.h (include Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |