Método IWDFIoRequest2::IsCanceled (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método IsCanceled determina se o gerente de E/S tentou cancelar uma solicitação de E/S.

Sintaxe

BOOL IsCanceled();

Retornar valor

IsCanceled retornaráTRUE se o gerente de E/S tentar cancelar a solicitação de E/S. Esse método retorna FALSE por qualquer um dos seguintes motivos:

• O gerente de E/S não tentou cancelar a solicitação.
• O driver de chamada não possui a solicitação.
• O driver de chamada chamou o método IWDFIoRequest::MarkCancelable .

Comentários

Se o driver não tiver chamado IWDFIoRequest::MarkCancelable para registrar uma função de retorno de chamada IRequestCallbackCancel::OnCancel , mas se você quiser que o driver determine se o gerente de E/S tentou cancelar uma solicitação de E/S, o driver poderá chamar IsCanceled.

Um driver pode chamar IsCanceled para uma solicitação somente se o driver possuir a solicitação de E/S. Se o driver tiver chamado IWDFIoRequest::MarkCancelable, ele deverá chamar IWDFIoRequest::UnmarkCancelable antes de chamar IsCanceled.

Se IsCanceled retornar TRUE, seu driver deverá cancelar a solicitação chamando IWDFIoRequest::Complete com o parâmetro CompletionStatus definido como HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

Para obter mais informações sobre IsCanceled, consulte Cancelando solicitações de E/S.

Exemplos

No exemplo de código a seguir, se IsCanceled retornar TRUE, o driver concluirá a solicitação de E/S chamando IWDFIoRequest::Complete com uma status de conclusão de HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

if (fxRequest2->IsCanceled())
{
    fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...

Requisitos

Confira também

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable