Funzione WdfRequestGetInformation (wdfrequest.h)
[Si applica a KMDF e UMDF]
Il metodo WdfRequestGetInformation restituisce informazioni sullo stato di completamento per una richiesta di I/O specificata.
Sintassi
ULONG_PTR WdfRequestGetInformation(
[in] WDFREQUEST Request
);
Parametri
[in] Request
Handle per un oggetto richiesta del framework.
Valore restituito
WdfRequestGetInformation restituisce le informazioni impostate da un driver di livello inferiore chiamando WdfRequestSetInformation o WdfRequestCompleteWithInformation.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Commenti
Un driver può chiamare WdfRequestSetInformation o WdfRequestCompleteWithInformation per impostare le informazioni sullo stato di completamento per una richiesta di I/O. Il driver può chiamare WdfRequestGetInformation dopo che un driver di livello inferiore completa una richiesta, per ottenere informazioni sullo stato di completamento impostate dal driver di livello inferiore.
Se il driver chiama WdfRequestGetInformation dopo aver chiamato WdfRequestComplete per completare la richiesta, WdfRequestGetInformation restituisce NULL.
Per altre informazioni su WdfRequestGetInformation, vedere Completamento delle richieste di I/O.
Esempio
L'esempio di codice seguente invia una richiesta di I/O a una destinazione di I/O e quindi ottiene le informazioni sullo stato fornite dalla destinazione di I/O.
ULONG_PTR informationRetrieved = NULL;
status = WdfIoTargetSendWriteSynchronously(
ioTarget,
request,
&outputMemoryDescriptor,
NULL,
NULL,
&bytesWritten
);
if (NT_SUCCESS(status)) {
informationRetrieved = WdfRequestGetInformation(request);
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfrequest.h (include Wdf.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |