Método IRequestCallbackCancel::OnCancel (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante 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 a UMDF.]
Se llama al método OnCancel cuando una aplicación cancela una operación de E/S a través de microsoft Win32 CancelIo, CancelIoExo función CancelSynchronousIo.
Sintaxis
void OnCancel(
[in] IWDFIoRequest *pWdfRequest
);
Parámetros
[in] pWdfRequest
Puntero a la interfaz IWDFIoRequest de que representa el objeto de solicitud de marco que se va a cancelar.
Valor devuelto
Ninguno
Observaciones
El marco llama al método OnCancel para cancelar la solicitud de E/S que identifica el parámetro pWdfRequest. El controlador debe determinar primero si puede cancelar la solicitud de E/S. Si se puede cancelar la solicitud, el controlador debe cancelarla. Para obtener más información sobre cómo cancelar una solicitud, consulte Cancelar solicitudes de E/S.
Si el controlador cancela la solicitud, el controlador también debe completar la solicitud llamando al método IWDFIoRequest::Complete con el parámetro CompletionStatus establecido en HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).
El marco no llama a onCancel para cancelar una solicitud a menos que el controlador haya llamado previamente a la interfaz IWDFIoRequest::MarkCancelable para habilitar la cancelación de la solicitud y registrar la interfaz IRequestCallbackCancel.
El marco de controlador de User-Mode (UMDF) solo permite un método OnCancel por cola. Por lo tanto, cuando un controlador llama a IWDFIoRequest::MarkCancelable para las solicitudes asociadas a una cola determinada para permitir que el marco cancele esas solicitudes, el controlador debe pasar un puntero al interfaz IRequestCallbackCancel para el mismo objeto de devolución de llamada de solicitud. Más adelante, para cancelar cada solicitud, el marco pasa un puntero a la interfaz de IWDFIoRequest de la solicitud en una llamada a la del objeto de devolución de llamada de solicitud onCancel.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Windows |
encabezado de | wudfddi.h (incluya Wudfddi.h) |