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 info, vedi Introduzione con UMDF.]
La funzione di callback dell'evento OnIoCanceledOnQueue di un driver 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 IWDFIoRequest per la richiesta di I/O.
Valore restituito
nessuno
Osservazioni
Un driver registra l'interfaccia IQueueCallbackIoCanceledOnQueue di una coda di I/O e la funzione di callback OnIoCanceledOnQueue quando il driver chiama IWDFDevice::CreateIoQueue. Per altre informazioni su come registrare l'interfaccia, vedere IQueueCallbackIoCanceledOnQueue.
Se un driver registra una funzione di callback OnIoCanceledOnQueue 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 accodare nuovamente la richiesta alla coda di I/O per cui è registrata la funzione di callback OnIoCanceledOnQueue , e l'operazione di I/O associata viene successivamente annullata.
Dopo che il framework chiama la funzione di callback OnIoCanceledOnQueue , il driver è proprietario dell'oggetto richiesta e pertanto deve annullare la richiesta.
Il framework non chiama la funzione di callback OnIoCanceledOnQueue del driver per le richieste di I/O che il framework non ha mai recapitato al driver.
Il framework chiama una funzione di callback OnIoCanceledOnQueue non appena determina che una richiesta di I/O è stata annullata, indipendentemente dal metodo di invio impostato dal driver per la coda di I/O. Pertanto, il framework può chiamare una funzione di callback OnIoCanceledOnQueue 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 Canceling I/O Requests.For more information about the OnIoCanceledOnQueue callback function, see Canceling I/O Requests.
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) |