Método IWDFIoRequest::CancelSentRequest (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. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
O método CancelSentRequest tenta cancelar a solicitação de E/S que o driver enviou anteriormente a um destino de E/S.
Sintaxe
BOOL CancelSentRequest();
Retornar valor
CancelSentRequest retorna um valor BOOL que indica se a solicitação de cancelamento foi entregue com êxito ao proprietário da solicitação. TRUE indica que a solicitação foi entregue com êxito. FALSE indica que a solicitação não foi entregue com êxito.
Comentários
Um driver pode chamar CancelSentRequest para tentar cancelar a solicitação de E/S que ele enviou anteriormente para um destino de E/S chamando o método IWDFIoRequest::Send .
Se a solicitação estiver na fila do destino de E/S, a estrutura cancelará a solicitação. Se a estrutura já tiver entregue a solicitação ao driver do destino de E/S e se esse driver tiver chamado anteriormente IWDFIoRequest::MarkCancelable para habilitar o cancelamento, a estrutura chamará o método IRequestCallbackCancel::OnCancel desse driver. Se o driver do destino não chamou IWDFIoRequest::MarkCancelable, a solicitação não será cancelada, a menos que a solicitação se torne cancelável posteriormente.
Se o driver tiver registrado anteriormente a interface IRequestCallbackRequestCompletion para a rotina de conclusão da solicitação, a estrutura chamará a rotina de conclusão depois que a solicitação for cancelada.
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.5 |
| Cabeçalho | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
Confira também
IRequestCallbackCancel::OnCancel