Método IQueueCallbackIoCanceledOnQueue::OnIoCanceledOnQueue (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.]

A função de retorno de chamada de evento OnIoCanceledOnQueue de um driver informa ao driver que uma solicitação de E/S foi cancelada enquanto estava em uma fila de E/S.

Sintaxe

void OnIoCanceledOnQueue(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest
);

Parâmetros

[in] pWdfQueue

Um ponteiro para a interface IWDFIoQueue para a fila de E/S em que a solicitação de E/S estava quando foi cancelada.

[in] pWdfRequest

Um ponteiro para a interface IWDFIoRequest para a solicitação de E/S.

Retornar valor

Nenhum

Comentários

Um driver registra a interface IQueueCallbackIoCanceledOnQueue de uma fila de E/S e a função de retorno de chamada OnIoCanceledOnQueue quando o driver chama o IWDFDevice::CreateIoQueue. Para obter mais informações sobre como registrar a interface, consulte IQueueCallbackIoCanceledOnQueue.

Se um driver registrar uma função de retorno de chamada OnIoCanceledOnQueue para uma fila de E/S, a estrutura chamará a função de retorno de chamada se um manipulador de solicitação receber uma solicitação de E/S de uma fila de E/S, o driver chamará IWDFIoRequest::ForwardToIoQueue ou IWDFIoRequest2::Requeue para redirecionar a solicitação para a fila de E/S para a qual a função de retorno de chamada OnIoCanceledOnQueue está registrada, e a operação de E/S associada é cancelada posteriormente.

Depois que a estrutura chama a função de retorno de chamada OnIoCanceledOnQueue , o driver é proprietário do objeto de solicitação e, portanto, deve cancelar a solicitação.

A estrutura não chama a função de retorno de chamada OnIoCanceledOnQueue do driver para solicitações de E/S que a estrutura nunca entregou ao driver.

A estrutura chama uma função de retorno de chamada OnIoCanceledOnQueue assim que determina que uma solicitação de E/S foi cancelada, independentemente do método de expedição que o driver definiu para a fila de E/S. Portanto, a estrutura pode chamar uma função de retorno de chamada OnIoCanceledOnQueue para uma solicitação em uma fila que usa expedição sequencial, mesmo que atualmente o driver possua outra solicitação da fila.

Para obter mais informações sobre a função de retorno de chamada OnIoCanceledOnQueue , consulte Cancelando solicitações de E/S.

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,9
Cabeçalho	wudfddi.h (include Wudfddi.h)

Confira também

IQueueCallbackIoCanceledOnQueue

IWDFDevice::CreateIoQueue

IWDFIoRequest::ForwardToIoQueue