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 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 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 di 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 deve non 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 da una CompletionRoutine funzione di callback.
Per altre informazioni su WdfRequestGetCompletionParams, vedere Completamento delle richieste di I/O.
Esempi
Nell'esempio di codice seguente viene inizializzata una struttura di WDF_REQUEST_COMPLETION_PARAMS e quindi viene chiamato WdfRequestGetCompletionParams.
WDF_REQUEST_COMPLETION_PARAMS completionParams;
WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
request,
&completionParams
);
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 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) |