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

Artigo
03/01/2024

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

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.

Retornar valor

Nenhum

Comentários

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 Cancelando solicitações de E/S.

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 UMDF (User-Mode Driver Framework) permite apenas um método OnCancel por fila. Portanto, quando um driver chama IWDFIoRequest::MarkCancelable para solicitações associadas a uma fila específica para habilitar a estrutura a cancelar essas solicitações, o driver deve passar um ponteiro para a interface IRequestCallbackCancel para o mesmo objeto request-callback. 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 desse objeto de retorno de chamada de solicitação.