Metodo IWDFIoRequest2::IsCanceled (wudfddi.h)

  • Articolo

[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 IsCanceled determina se il gestore di I/O ha tentato di annullare una richiesta di I/O.

Sintassi

BOOL IsCanceled();

Valore restituito

IsCanceled restituisce TRUE se il gestore di I/O ha tentato di annullare la richiesta di I/O. Questo metodo restituisce FALSE per uno dei motivi seguenti:

  • Il gestore di I/O non ha tentato di annullare la richiesta.
  • Il driver chiamante non possiede la richiesta.
  • Il driver chiamante ha chiamato il metodo IWDFIoRequest::MarkCancelable .

Commenti

Se il driver non ha chiamato IWDFIoRequest::MarkCancelable per registrare una funzione di callback IRequestCallbackCancel::OnCancel , ma se si vuole che il driver determini se il gestore di I/O ha tentato di annullare una richiesta di I/O, il driver può chiamare IsCanceled.

Un driver può chiamare IsCanceled per una richiesta solo se il driver possiede la richiesta di I/O. Se il driver ha chiamato IWDFIoRequest::MarkCancelable, deve chiamare IWDFIoRequest::UnmarkCancelable prima di chiamare IsCanceled.

Se IsCanceled restituisce TRUE, il driver deve annullare la richiesta chiamando IWDFIoRequest::Complete con il parametro CompletionStatus impostato su HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

Per altre informazioni su IsCanceled, vedere Annullamento delle richieste di I/O.

Esempio

Nell'esempio di codice seguente, se IsCanceled restituisce TRUE, il driver completa la richiesta di I/O chiamando IWDFIoRequest::Complete con lo stato di completamento di HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

if (fxRequest2->IsCanceled())
{
    fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...

Requisiti

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1,9
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Vedi anche

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable