Compartilhar via

Método IWDFIoQueue::D rain (wudfddi.h)

  • Artigo

[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 Drain direciona a fila para rejeitar novas solicitações de E/S de entrada e permitir que solicitações já enfileiradas sejam entregues ao driver para processamento.

Sintaxe

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

Parâmetros

[in, optional] pDrainComplete

Um ponteiro para a interface IQueueCallbackStateChange cujo método a estrutura chama para entregar o estado da fila ao driver. A estrutura chama o método depois que todas as solicitações são concluídas ou canceladas e a fila está vazia. Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

Nenhum

Observações

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

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

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

Consulte também

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop