Método IWDFIoRequest::CancelSentRequest (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 CancelSentRequest tenta cancelar a solicitação de E/S que o driver enviou anteriormente a um destino de E/S.
Sintaxe
BOOL CancelSentRequest();
Valor de retorno
CancelSentRequest retorna um valor BOOL que indica se a solicitação de cancelamento foi entregue com êxito ao proprietário da solicitação. VERDADEIRO indica que a solicitação foi entregue com êxito. FALSE indica que a solicitação não foi entregue com êxito.
Observações
Um driver pode chamar CancelSentRequest para tentar cancelar a solicitação de E/S enviada 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 de destino de E/S e se esse driver anteriormente chamado IWDFIoRequest::MarkCancelable para habilitar o cancelamento, a estrutura chamará o método IRequestCallbackCancel::OnCancel do driver. Se o driver do destino não tiver chamado IWDFIoRequest::MarkCancelable, a solicitação não será cancelada, a menos que a solicitação se torne cancelável posteriormente.
Se o driver registrou anteriormente a interface IRequestCallbackRequestCompletion para a rotina de conclusão da solicitação, a estrutura chamará a rotina de conclusão após o cancelamento da solicitação.
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.5 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |
Consulte também
IRequestCallbackCancel::OnCancel