Metodo IRequestCallbackCancel::OnCancel (wudfddi.h)

Articolo
02/27/2024

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]

Il metodo OnCancel viene chiamato quando un'applicazione annulla un'operazione di I/O tramite la funzione CancelIo, CancelIoEx o CancelSynchronousIo.

Sintassi

void OnCancel(
  [in] IWDFIoRequest *pWdfRequest
);

Parametri

[in] pWdfRequest

Puntatore all'interfaccia IWDFIoRequest che rappresenta l'oggetto richiesta del framework da annullare.

Valore restituito

nessuno

Osservazioni

Il framework chiama il metodo OnCancel per annullare la richiesta di I/O identificata dal parametro pWdfRequest . Il driver deve prima determinare se può annullare la richiesta di I/O. Se la richiesta può essere annullata, il driver deve annullarlo. Per altre informazioni su come annullare una richiesta, vedere Annullamento delle richieste di I/O.

Se il driver annulla la richiesta, il driver deve anche completare la richiesta chiamando il metodo IWDFIoRequest::Complete con il parametro CompletionStatus impostato su HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

Il framework non chiama OnCancel per annullare una richiesta a meno che il driver precedentemente chiamato il metodo IWDFIoRequest::MarkCancelable per abilitare l'annullamento della richiesta e registrare l'interfaccia IRequestCallbackCancel .

Il User-Mode Driver Framework (UMDF) consente un solo metodo OnCancel per coda. Pertanto, quando un driver chiama IWDFIoRequest::MarkCancelable per le richieste associate a una determinata coda per consentire al framework di annullare tali richieste, il driver deve passare un puntatore all'interfaccia IRequestCallbackCancel per lo stesso oggetto request-callback. Successivamente, per annullare ogni richiesta, il framework passa un puntatore all'interfaccia IWDFIoRequest per la richiesta in una chiamata a questo metodo OnCancel dell'oggetto request-callback.