Método IQueueCallbackIoStop::OnIoStop (wudfddi.h)

Artigo
02/27/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.]

A função de retorno de chamada OnIoStop interrompe o processamento da solicitação de E/S especificada da fila especificada.

Sintaxe

void OnIoStop(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] ULONG         ActionFlags
);

Parâmetros

[in] pWdfQueue

Um ponteiro para a interface IWDFIoQueue para o objeto de fila de E/S do qual o processamento da solicitação de E/S é interrompido.

[in] pWdfRequest

Um ponteiro para a interface IWDFIoRequest que representa o objeto de solicitação de estrutura cujo processamento é interrompido.

[in] ActionFlags

Um OR bit a bit válido de valores de tipo WDF_REQUEST_STOP_ACTION_FLAGS que identifica o estado de uma solicitação de ação de parada.

Retornar valor

Nenhum

Comentários

Um driver registra a interface IQueueCallbackIoStop quando o driver chama o método IWDFDevice::CreateIoQueue para criar uma fila de E/S ou para configurar a fila de E/S padrão.

Se um driver registrar uma função de retorno de chamada OnIoStop para uma fila de E/S, a estrutura a chamará quando o dispositivo subjacente da fila estiver deixando seu estado de trabalho (D0). A estrutura chama a função de retorno de chamada OnIoStop para cada solicitação de E/S que o driver não concluiu, incluindo solicitações que o driver possui e aquelas que ele encaminhou para um destino de E/S.

A função de retorno de chamada OnIoStop deve concluir, cancelar ou adiar o processamento adicional da solicitação de E/S. Você deve usar as seguintes regras:

Se o driver possui a solicitação de E/S, ele deve chamar IWDFIoRequest::Complete para concluir ou cancelar a solicitação ou deve adiar o processamento adicional da solicitação e, em seguida, chamar IWDFIoRequest2::StopAcknowledge.

Se o driver encaminhou a solicitação de E/S para um destino de E/S, ele deve chamar IWDFIoRequest::CancelSentRequest para tentar cancelar a solicitação ou deve adiar o processamento adicional da solicitação e, em seguida, chamar StopAcknowledge.

Se o sinalizador WdfRequestStopRequestCancelable estiver definido no parâmetro ActionFlags , o driver deverá chamar IWDFIoRequest::UnmarkCancelable antes de chamar IWDFIoRequest::Complete para concluir (ou cancelar) a solicitação ou chamar IWDFIoRequest2::StopAcknowledge para redirecionar a solicitação.