Método IQueueCallbackIoCanceledOnQueue::OnIoCanceledOnQueue (wudfddi.h)

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

La función de devolución de llamada de eventos OnIoCanceledOnQueue de un controlador informa al controlador de que se canceló una solicitud de E/S mientras estaba en una cola de E/S.

Sintaxis

void OnIoCanceledOnQueue(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest
);

Parámetros

[in] pWdfQueue

Puntero a la interfaz IWDFIoQueue de la cola de E/S en la que se encontraba la solicitud de E/S cuando se canceló.

[in] pWdfRequest

Puntero a la interfaz IWDFIoRequest para la solicitud de E/S.

Valor devuelto

None

Observaciones

Un controlador registra la interfaz IQueueCallbackIoCanceledOnQueue de una cola de E/S y la función de devolución de llamada OnIoCanceledOnQueue cuando el controlador llama a IWDFDevice::CreateIoQueue. Para obtener más información sobre cómo registrar la interfaz, vea IQueueCallbackIoCanceledOnQueue.

Si un controlador registra una función de devolución de llamada OnIoCanceledOnQueue para una cola de E/S, el marco llama a la función de devolución de llamada si un controlador de solicitudes recibe una solicitud de E/S de una cola de E/S, el controlador llama a IWDFIoRequest::ForwardToIoQueue o IWDFIoRequest2::Requeue para volver a poner en cola la solicitud a la cola de E/S para la que se registra la función de devolución de llamada OnIoCanceledOnQueue , y la operación de E/S asociada se cancela posteriormente.

Una vez que el marco llama a la función de devolución de llamada OnIoCanceledOnQueue , el controlador posee el objeto de solicitud y, por lo tanto, debe cancelar la solicitud.

El marco de trabajo no llama a la función de devolución de llamada OnIoCanceledOnQueue del controlador para las solicitudes de E/S que el marco nunca ha entregado al controlador.

El marco llama a una función de devolución de llamada OnIoCanceledOnQueue en cuanto determina que se ha cancelado una solicitud de E/S, independientemente del método de envío que el controlador haya establecido para la cola de E/S. Por lo tanto, el marco puede llamar a una función de devolución de llamada OnIoCanceledOnQueue para una solicitud en una cola que usa la distribución secuencial, incluso si el controlador posee actualmente otra solicitud de la cola.

Para obtener más información sobre la función de devolución de llamada OnIoCanceledOnQueue , vea Cancelar solicitudes de E/S.

Requisitos

Requisito	Value
Finalización del soporte técnico	No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino	Escritorio
Versión mínima de UMDF	1,9
Encabezado	wudfddi.h (incluya Wudfddi.h)

Consulte también

IQueueCallbackIoCanceledOnQueue

IWDFDevice::CreateIoQueue

IWDFIoRequest::ForwardToIoQueue