Método IWDFIoRequest2::IsCanceled (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo 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 aoda UMDF .]
O método IsCanceled determina se o gerente de E/S tentou cancelar uma solicitação de E/S.
Sintaxe
BOOL IsCanceled();
Valor de retorno
IsCanceled retornará verdadeiro se o gerente de E/S tiver tentado 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.
Observações
Se o driver não tiver chamado função de retorno de chamada 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 pode chamar IsCanceled.
Um driver pode chamar IsCanceled para uma solicitação somente se o driver tiver 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 verdadeiro, 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 I/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
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.9 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |