Método IWDFIoRequest::CancelSentRequest (wudfddi.h)

  • Artículo

[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.

El método CancelSentRequest intenta cancelar la solicitud de E/S que el controlador envió previamente a un destino de E/S.

Sintaxis

BOOL CancelSentRequest();

Valor devuelto

CancelSentRequest devuelve un valor BOOL que indica si la solicitud de cancelación se entregó correctamente al propietario de la solicitud. TRUE indica que la solicitud se entregó correctamente. FALSE indica que la solicitud no se entregó correctamente.

Comentarios

Un controlador puede llamar a CancelSentRequest para intentar cancelar la solicitud de E/S que anteriormente envió a un destino de E/S llamando al método IWDFIoRequest::Send .

Si la solicitud está en la cola del destino de E/S, el marco cancela la solicitud. Si el marco de trabajo ya entregó la solicitud al controlador del destino de E/S y si ese controlador llamó anteriormente al método IWDFIoRequest::MarkCancelable para habilitar la cancelación, el marco llama al método IRequestCallbackCancel::OnCancel del controlador. Si el controlador del destino no llamó a IWDFIoRequest::MarkCancelable, la solicitud no se cancela a menos que la solicitud se pueda cancelar posteriormente.

Si el controlador registró previamente la interfaz IRequestCallbackRequestCompletion para la rutina de finalización de la solicitud, el marco llama a la rutina de finalización después de cancelar la solicitud.

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.5
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IRequestCallbackCancel::OnCancel

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest::MarkCancelable

IWDFIoRequest::Send