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
| Requisito | Valor |
|---|---|
| Fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1,9 |
| Cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| DLL | WUDFx.dll |