Metodo IQueueCallbackIoCanceledOnQueue::OnIoCanceledOnQueue (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 informazioni, vedi Introduzione a UMDF.]
La di un driver OnIoCanceledOnQueue funzione di callback degli eventi informa il driver che una richiesta di I/O è stata annullata mentre si trovava in una coda di I/O.
Sintassi
void OnIoCanceledOnQueue(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest
);
Parametri
[in] pWdfQueue
Puntatore all'interfaccia IWDFIoQueue per la coda di I/O in cui si trovava la richiesta di I/O quando è stata annullata.
[in] pWdfRequest
Puntatore all'interfaccia di IWDFIoRequest per la richiesta di I/O.
Valore restituito
Nessuno
Osservazioni
Un driver registra l'interfaccia di di una coda IQueueCallbackIoCanceledOnQueue e OnIoCanceledOnQueue funzione di callback quando il driver chiama il IWDFDevice::CreateIoQueue. Per altre informazioni su come registrare l'interfaccia, vedere IQueueCallbackIoCanceledOnQueue.
Se un driver registra un OnIoCanceledOnQueue funzione di callback per una coda di I/O, il framework chiama la funzione di callback se un gestore di richieste riceve una richiesta di I/O da una coda di I/O, il driver chiama IWDFIoRequest::ForwardToIoQueue o IWDFIoRequest2::Requeue per rieseguere la richiesta alla coda di I/O per cui la funzione di callback OnIoCanceledOnQueue è registrata, e l'operazione di I/O associata viene successivamente annullata.
Dopo che il framework chiama il OnIoCanceledOnQueue funzione di callback, il driver è proprietario dell'oggetto richiesta e, pertanto, deve annullare la richiesta.
Il framework non chiama il del driver OnIoCanceledOnQueue funzione di callback per le richieste di I/O che il framework non ha mai recapitato al driver.
Il framework chiama una OnIoCanceledOnQueue funzione di callback non appena determina che una richiesta di I/O è stata annullata, indipendentemente dal metodo di invio impostato per la coda di I/O. Pertanto, il framework può chiamare un OnIoCanceledOnQueue funzione di callback per una richiesta in una coda che usa l'invio sequenziale, anche se il driver è attualmente proprietario di un'altra richiesta dalla coda.
Per altre informazioni sulla funzione di callback OnIoCanceledOnQueue, vedere Annullamento delle richieste di I/O.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.9 |
| intestazione | wudfddi.h (include Wudfddi.h) |