Método IWDFIoQueue::Stop (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo 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 aoda UMDF .]
O método Parar impede que uma fila de E/S forneça 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 forem concluídas. Esse parâmetro é opcional e pode ser NULL.
Valor de retorno
Nenhum
Observações
Uma chamada para Parar é assíncrona e retorna imediatamente ao driver. O driver é notificado por meio do método da interface de 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 Drain ou Purge. Violar essa regra resulta no encerramento do processo de host.O método Parar 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. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.5 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |