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 info, vedi Introduzione con 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 metodo OnCompletion registrato in precedenza.
[in, optional] pContext
Puntatore a un buffer contenente 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.
Esempio
Per un esempio di codice su come usare il metodo SetCompletionCallback , vedere IWDFIoRequest::Send.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
Vedi anche
IRequestCallbackRequestCompletion