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 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.
Se llama al método OnCancel cuando una aplicación cancela una operación de E/S a través de la función CancelIo, CancelIoEx o CancelSynchronousIo de Microsoft Win32.
Sintaxis
void OnCancel(
[in] IWDFIoRequest *pWdfRequest
);
Parámetros
[in] pWdfRequest
Puntero a la interfaz IWDFIoRequest que representa el objeto de solicitud de marco que se va a cancelar.
Valor devuelto
None
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 Cancelación de 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 de trabajo no llama a OnCancel para cancelar una solicitud a menos que el controlador haya llamado anteriormente al método 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 a la 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 IWDFIoRequest de la solicitud en una llamada a este método OnCancel del objeto request-callback.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |