Cancelando solicitações de E/S
A operação de E/S em andamento de um dispositivo (como uma solicitação para ler vários blocos de um disco) pode ser cancelada por um aplicativo, pelo sistema ou por um driver. Se a operação de E/S de um dispositivo for cancelada, o gerente de E/S tentará cancelar todas as solicitações de E/S não processadas associadas à operação de E/S. Os drivers do dispositivo podem se registrar para serem notificados quando o gerente de E/S tenta cancelar solicitações de E/S e os drivers podem cancelar as solicitações que possuem concluindo-as com uma status de conclusão de STATUS_CANCELLED.
A estrutura lida com alguns dos trabalhos de cancelamento para drivers baseados em estrutura. Se a operação de E/S de um dispositivo for cancelada, a estrutura concluirá as seguintes solicitações de E/S (com uma status de conclusão de STATUS_CANCELLED) associadas à operação cancelada:
Solicitações de E/S não entregues que a estrutura colocou na fila de E/S padrão do driver.
Solicitações de E/S não entregues que a estrutura encaminhou para outra fila porque o driver chamou WdfDeviceConfigureRequestDispatching.
Como a estrutura cancela essas solicitações, ela não as entrega ao driver.
Depois que a estrutura tiver entregue uma solicitação de E/S ao driver, o driver será proprietário da solicitação e a estrutura não poderá cancelá-la. Neste ponto, somente o driver pode cancelar a solicitação de E/S, mas a estrutura deve notificar o driver de que uma solicitação deve ser cancelada. Os drivers recebem essa notificação fornecendo uma função de retorno de chamada EvtRequestCancel .
Às vezes, um driver recebe uma solicitação de E/S de uma fila de E/S, mas, em vez de processar a solicitação, o driver requeusa a solicitação para a mesma fila de E/S para processamento posterior. Exemplos dessa situação incluem o seguinte:
A estrutura fornece uma solicitação de E/S para um dos manipuladores de solicitação do driver e o driver chama posteriormente WdfRequestForwardToIoQueue (ou WdfRequestForwardToParentDeviceIoQueue) para colocar a solicitação em uma fila diferente ou WdfRequestRequeue para colocar a solicitação de volta na mesma fila.
A estrutura fornece uma solicitação de E/S para a função de retorno de chamada EvtIoInCallerContext do driver, o driver chama WdfDeviceEnqueueRequest para passar a solicitação de volta para a estrutura e a estrutura coloca posteriormente a solicitação em uma das filas de E/S do driver.
Nesses casos, a estrutura pode cancelar a solicitação de E/S porque a solicitação está em uma fila de E/S. No entanto, se o driver tiver registrado uma função de retorno de chamada EvtIoCanceledOnQueue para a fila de E/S na qual a solicitação reside, a estrutura chamará a função de retorno de chamada, em vez de cancelar a solicitação, quando a operação de E/S associada estiver sendo cancelada. Se a estrutura chamar a função de retorno de chamada EvtIoCanceledOnQueue do driver, o driver deverá concluir a solicitação.
Em resumo, quando uma operação de E/S é cancelada, a estrutura sempre cancela todas as solicitações de E/S associadas que nunca foram entregues ao driver. Se o driver receber uma solicitação e, em seguida, requeuí-la, a estrutura cancelará a solicitação (se a solicitação estiver na fila), a menos que o driver forneça uma função de retorno de chamada EvtIoCanceledOnQueue para a fila de E/S.
Chamando WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx
Um driver pode chamar WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx para registrar uma função de retorno de chamada EvtRequestCancel . Se o driver tiver chamado WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx e se a operação de E/S associada à solicitação for cancelada, a estrutura chamará a função de retorno de chamada EvtRequestCancel do driver para que o driver possa cancelar a solicitação de E/S.
Um driver deve chamar WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx se ele tiver uma solicitação por um tempo relativamente longo. Por exemplo, um driver pode ter que aguardar a resposta de um dispositivo ou aguardar que drivers inferiores concluam um conjunto de solicitações que o driver criou quando recebeu uma única solicitação.
Se um driver não chamar WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx ou se um driver chamar WdfRequestUnmarkCancelable depois de chamar WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx, o driver não estará ciente do cancelamento e, portanto, manipulará a solicitação como normalmente faria.
Chamando WdfRequestIsCanceled
Se um driver não tiver chamado WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx para registrar uma função de retorno de chamada EvtRequestCancel , ele poderá chamar WdfRequestIsCanceled para determinar se o gerente de E/S tentou cancelar uma solicitação de E/S. Se WdfRequestIsCanceled retornar TRUE e o driver possuir a solicitação, o driver deverá cancelar a solicitação. Se o driver não possui a solicitação, ele não deve chamar WdfRequestIsCanceled.
Um driver que não chamou WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx pode chamar WdfRequestIsCanceled nas seguintes circunstâncias:
Um driver que aguarda interrupções de dispositivo pode chamar WdfRequestIsCanceled de sua função de retorno de chamada EvtInterruptDpc .
Um driver que sonda seu dispositivo pode chamar WdfRequestIsCanceled do thread de sondagem.
Um driver que divide uma transação DMA em várias transferências menores pode chamar WdfRequestIsCanceled após a conclusão de cada transferência.
Um driver que recebe uma solicitação de leitura ou gravação grande que ele divide em várias solicitações menores pode chamar WdfRequestIsCanceled depois que o destino de E/S do driver concluir cada uma das solicitações menores, se o driver não tiver chamado WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx para a solicitação recebida.
Cancelando a solicitação
Cancelar uma solicitação de E/S pode envolver qualquer uma das seguintes opções:
Interrompendo uma operação de E/S em andamento.
Não encaminhar a solicitação para um destino de E/S.
Chamar WdfRequestCancelSentRequest para tentar cancelar uma solicitação que o driver havia enviado anteriormente a um destino de E/S.
Se um driver estiver cancelando uma solicitação de E/S para um objeto de solicitação que o driver recebeu da estrutura, o driver sempre deverá concluir a solicitação chamando WdfRequestComplete, WdfRequestCompleteWithInformation ou WdfRequestCompleteWithPriorityBoost, com um parâmetro Status de STATUS_CANCELLED. (Se o driver chamado WdfRequestCreate criar um objeto de solicitação, o driver chamará WdfObjectDelete em vez de concluir a solicitação.)
Sincronizando o cancelamento
Para obter informações sobre como sincronizar o código que cancela solicitações de E/S, consulte: