Funzione WdfRequestSetCompletionRoutine (wdfrequest.h)
[Si applica a KMDF e UMDF]
Il metodo WdfRequestSetCompletionRoutine registra o annulla la registrazione di una routine di completamento per l'oggetto richiesta framework specificato.
Sintassi
void WdfRequestSetCompletionRoutine(
[in] WDFREQUEST Request,
[in, optional] PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine,
[in, optional] __drv_aliasesMem WDFCONTEXT CompletionContext
);
Parametri
[in] Request
Handle per un oggetto richiesta framework.
[in, optional] CompletionRoutine
Puntatore a un CompletionRoutine funzione di callback, se il driver registra una routine di completamento o NULL del driver sta registrando una routine di completamento registrata in precedenza.
[in, optional] CompletionContext
Puntatore non tipizzato alle informazioni sul contesto definite dal driver che il framework passa alla CompletionRoutine funzione di callback. Questo parametro è facoltativo e può essere NULL.
Valore restituito
Nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Se il driver inoltra le richieste di I/O, ma se si vuole che il driver venga informato quando un driver di livello inferiore completa la richiesta, il driver può fornire un CompletionRoutine funzione di callback e chiamare WdfRequestSetCompletionRoutine per registrare la funzione. Il framework chiama la funzione di callback dopo che un driver di livello inferiore completa la richiesta di I/O.
Per altre informazioni su WdfRequestSetCompletionRoutine, vedere completamento delle richieste di I/O.
Esempi
Per un esempio di codice che usa WdfRequestSetCompletionRoutine, vedere WdfRequestSend.
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), ReqCompletionRoutine(kmdf) |