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

[Aviso: UMDF 2 é a versão mais recente da 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();

Valor retornado

IsCanceled retornaráTRUE se o gerente de E/S tentar cancelar a solicitação de E/S. Este 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, o 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 Canceling E/S Requests.

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 um status de conclusão de HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

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

Requisitos

   
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Desktop
Versão mínima do UMDF 1,9
Cabeçalho wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Confira também

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable