Método IWDFIoRequest2::IsCanceled (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 IsCanceled determina si el administrador de E/S ha intentado cancelar una solicitud de E/S.
Sintaxis
BOOL IsCanceled();
Valor devuelto
IsCanceled devuelve TRUE si el administrador de E/S ha intentado cancelar la solicitud de E/S. Este método devuelve false por cualquiera de los siguientes motivos:
- El administrador de E/S no ha intentado cancelar la solicitud.
- El controlador de llamada no posee la solicitud.
- El controlador de llamada ha llamado al método IWDFIoRequest::MarkCancelable.
Observaciones
Si el controlador no ha llamado a IWDFIoRequest::MarkCancelable para registrar una IRequestCallbackCancel::OnCancel función de devolución de llamada, pero si desea que el controlador determine si el administrador de E/S ha intentado cancelar una solicitud de E/S, el controlador puede llamar a IsCanceled.
Un controlador puede llamar a IsCanceled para una solicitud solo si el controlador posee la solicitud de E/S. Si el controlador ha llamado a IWDFIoRequest::MarkCancelable, debe llamar a IWDFIoRequest::UnmarkCancelable antes de llamar a IsCanceled.
Si isCanceled devuelve TRUE, el controlador debe cancelar la solicitud llamando a IWDFIoRequest::Complete con el parámetro CompletionStatus establecido en HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).
Para obtener más información sobre isCanceled, vea cancelación de solicitudes de E/S.
Ejemplos
En el ejemplo de código siguiente, si isCanceled devuelve TRUE, el controlador completa la solicitud de E/S llamando a IWDFIoRequest::Complete con un estado de finalización de HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).
if (fxRequest2->IsCanceled())
{
fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...
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.9 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |