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

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest

IWDFIoRequest::Send