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 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 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 que realiza la llamada no es el propietario de la solicitud.
- El controlador de llamada ha llamado al método IWDFIoRequest::MarkCancelable .
Comentarios
Si el controlador no ha llamado a IWDFIoRequest::MarkCancelable para registrar una función de devolución de llamada IRequestCallbackCancel::OnCancel , 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, consulte 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 mediante una llamada 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 | 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,9 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |