Funzione WdfRequestGetCompletionParams (wdfrequest.h)
[Si applica a KMDF e UMDF]
Il metodo WdfRequestGetCompletionParams recupera i parametri di completamento I/O associati a un oggetto richiesta framework specificato.
Sintassi
void WdfRequestGetCompletionParams(
[in] WDFREQUEST Request,
[in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);
Parametri
[in] Request
Handle per un oggetto richiesta del framework.
[in, out] Params
Puntatore a una struttura di WDF_REQUEST_COMPLETION_PARAMS fornita dal chiamante.
Valore restituito
nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Dopo che un driver ha chiamato WdfRequestSend per inviare in modo sincrono o asincrono una richiesta di I/O a una destinazione di I/O e dopo che la destinazione di I/O ha completato la richiesta di I/O, il driver può chiamare WdfRequestGetCompletionParams per ottenere i parametri di completamento della richiesta di I/O.
La struttura dei parametri di completamento contiene informazioni valide solo se il driver ha formattato la richiesta chiamando uno dei metodi WdfIoTargetFormatXxx . Ad esempio, vedere WdfIoTargetFormatRequestForRead.
Si noti che se il driver chiama uno dei metodi che invia richieste di I/O alle destinazioni di I/O solo in modo sincrono (ad esempio WdfIoTargetSendReadSynchronously), il driver non deve chiamare WdfRequestGetCompletionParams.
Il metodo WdfRequestGetCompletionParams copia i parametri di completamento della richiesta di I/O nella struttura di WDF_REQUEST_COMPLETION_PARAMS specificata.
Se un driver invia una richiesta di I/O in modo asincrono, in genere chiama questo metodo dall'interno di una funzione di callback CompletionRoutine .
Per altre informazioni su WdfRequestGetCompletionParams, vedere Completamento delle richieste di I/O.
Esempio
L'esempio di codice seguente inizializza una struttura WDF_REQUEST_COMPLETION_PARAMS e quindi chiama WdfRequestGetCompletionParams.
WDF_REQUEST_COMPLETION_PARAMS completionParams;
WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
request,
&completionParams
);
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) |