Funzione WdfRequestGetCompletionParams (wdfrequest.h)

  • Articolo

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

Vedi anche

CompletionRoutine

WDF_REQUEST_COMPLETION_PARAMS

WDF_REQUEST_COMPLETION_PARAMS_INIT