Método IWDFIoRequest::CancelSentRequest (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.]
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.
Observaciones
Un controlador puede llamar a cancelSentRequest para intentar cancelar la solicitud de E/S que envió previamente 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 ya entregó la solicitud al controlador del destino de E/S y si ese controlador llamó anteriormente IWDFIoRequest::MarkCancelable para habilitar la cancelación, el marco llama al método IRequestCallbackCancel::OnCancel. Si el controlador del destino no llamó a IWDFIoRequest::MarkCancelable, la solicitud no se cancela a menos que la solicitud se cancele posteriormente.
Si el controlador registró previamente el IRequestCallbackRequestCompletion interfaz 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 | Valor |
---|---|
fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
de la plataforma de destino de | Escritorio |
versión mínima de UMDF | 1.5 |
encabezado de | wudfddi.h (incluya Wudfddi.h) |
DLL de | WUDFx.dll |
Consulte también
IRequestCallbackCancel::OnCancel