Metodo IWDFIoRequest::CancelSentRequest (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 CancelSentRequest tenta di annullare la richiesta di I/O inviata in precedenza al driver a una destinazione di I/O.

Sintassi

BOOL CancelSentRequest();

Valore restituito

CancelSentRequest restituisce un valore BOOL che indica se la richiesta di annullamento è stata recapitata correttamente al proprietario della richiesta. TRUE indica che la richiesta è stata recapitata correttamente. FALSE indica che la richiesta non è stata recapitata correttamente.

Commenti

Un driver può chiamare CancelSentRequest per tentare di annullare la richiesta di I/O inviata in precedenza a una destinazione di I/O chiamando il metodo IWDFIoRequest::Send .

Se la richiesta si trova nella coda della destinazione di I/O, il framework annulla la richiesta. Se il framework ha già recapitato la richiesta al driver della destinazione I/O e se il driver precedentemente denominato IWDFIoRequest::MarkCancelable per abilitare l'annullamento, il framework chiama il metodo IRequestCallbackCancel::OnCancel del driver. Se il driver di destinazione non ha chiamato IWDFIoRequest::MarkCancelable, la richiesta non viene annullata a meno che la richiesta non diventi successivamente annullabile.

Se il driver ha registrato in precedenza l'interfaccia IRequestCallbackRequestCompletion per la routine di completamento della richiesta, il framework chiama la routine di completamento dopo l'annullamento della richiesta.

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

IRequestCallbackCancel::OnCancel

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest::MarkCancelable

IWDFIoRequest::Send