Método IWDFIoQueue::Stop (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. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método Stop impede que uma fila de E/S entregue solicitações de E/S, mas a fila recebe e armazena novas solicitações.

Sintaxe

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

Parâmetros

[in, optional] pStopComplete

Um ponteiro para a interface IQueueCallbackStateChange cujo método a estrutura chama após todas as solicitações de E/S pendentes, se houver, no driver são concluídas. Esse parâmetro é opcional e pode ser NULL.

Retornar valor

Nenhum

Comentários

Uma chamada para Parar é assíncrona e retorna imediatamente ao driver. O driver é notificado por meio do método da interface IQueueCallbackStateChange fornecida após a conclusão de todas as solicitações pendentes no driver.

O driver deve garantir que apenas um dos seguintes métodos esteja em andamento a qualquer momento:

Por exemplo, se o driver anteriormente chamado Parar, ele deverá aguardar a notificação do método da interface para o qual o parâmetro pStopComplete aponta antes que o driver chame Esvaziar ou Limpar. Violar essa regra resulta no encerramento do processo de host.

O método Stop permite que a fila receba novas solicitações, mesmo que a fila não estivesse recebendo novas solicitações antes do driver chamado Parar. Por exemplo, um driver pode chamar IWDFIoQueue::D rain, o que faz com que a estrutura pare de adicionar novas solicitações de E/S à fila. A chamada subsequente do driver de Parar faz com que a estrutura retome a adição de solicitações à fila.

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.5
Cabeçalho wudfddi.h (inclua Wudfddi.h)
DLL WUDFx.dll

Confira também

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge