Metodo IWDFIoRequest::SetCompletionCallback (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Il metodo SetCompletionCallback registra l'interfaccia per il metodo OnCompletion che il framework deve chiamare al termine di una richiesta di I/O.
Sintassi
void SetCompletionCallback(
[in] IRequestCallbackRequestCompletion *pCompletionCallback,
[in, optional] void *pContext
);
Parametri
[in] pCompletionCallback
Puntatore all'interfaccia IRequestCallbackRequestCompletion il cui metodo OnCompletion chiama il framework al termine della richiesta di I/O. A partire dalla versione 1.9 di UMDF, il driver può specificare NULL per annullare la registrazione di un registrato in precedenza.
[in, optional] pContext
Puntatore a un buffer che contiene informazioni di contesto correlate al completamento della richiesta. Il framework passa queste informazioni di contesto in una chiamata al metodo IRequestCallbackRequestCompletion::OnCompletion. Questo parametro è facoltativo e può essere NULL.
Valore restituito
Nessuno
Osservazioni
Se un driver che inoltra una richiesta di I/O richiede una notifica quando il driver di livello inferiore completa la richiesta, il driver può fornire una routine di completamento e chiamare SetCompletionCallback per registrare l'interfaccia IRequestCallbackRequestCompletion per la routine di completamento. Il framework chiama la routine di completamento dopo che il driver di livello inferiore completa la richiesta di I/O.
Esempi
Per un esempio di codice su come usare il metodo setCompletionCallback, vedere IWDFIoRequest::Send.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |
Vedere anche
IRequestCallbackRequestCompletion