Método IRequestCallbackCancel::OnCancel (wudfddi.h)

Artigo
02/07/2025

[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 OnCancel é chamado quando um aplicativo cancela uma operação de E/S por meio da função CancelIoMicrosoft Win32, CancelIoExou função CancelSynchronousIo.

Sintaxe

void OnCancel(
  [in] IWDFIoRequest *pWdfRequest
);

Parâmetros

[in] pWdfRequest

Um ponteiro para a interface IWDFIoRequest que representa o objeto de solicitação de estrutura a ser cancelado.

Valor de retorno

Nenhum

Observações

A estrutura chama o método OnCancel para cancelar a solicitação de E/S que o parâmetro pWdfRequest identifica. O driver deve primeiro determinar se ele pode cancelar a solicitação de E/S. Se a solicitação puder ser cancelada, o driver deverá cancelá-la. Para obter mais informações sobre como cancelar uma solicitação, consulte Canceling I/S Requests.

Se o driver cancelar a solicitação, o driver também deverá concluir a solicitação chamando o método IWDFIoRequest::Complete com o parâmetro CompletionStatus definido como HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

A estrutura não chama OnCancel para cancelar uma solicitação, a menos que o driver tenha chamado anteriormente o método IWDFIoRequest::MarkCancelable para habilitar o cancelamento da solicitação e registrar a interface IRequestCallbackCancel.

O User-Mode Driver Framework (UMDF) permite apenas um método OnCancel por fila. Portanto, quando um driver chama IWDFIoRequest::MarkCancelable para solicitações associadas a uma determinada fila para habilitar a estrutura a cancelar essas solicitações, o driver deve passar um ponteiro para a interface IRequestCallbackCancel para o mesmo objeto de retorno de chamada de solicitação. Posteriormente, para cancelar cada solicitação, a estrutura passa um ponteiro para a interface IWDFIoRequest para a solicitação em uma chamada para o método onCancel deste objeto de retorno de chamada de solicitação.