Metodo IWDFIoRequest2::IsCanceled (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 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 |