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

Consulte también

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable