Função WdfIoQueueStopSynchronously (wdfio.h)

[Aplica-se a KMDF e UMDF]

O método WdfIoQueueStopSynchronously impede que uma fila de E/S entregue solicitações de E/S, mas a fila recebe e armazena novas solicitações. O método retorna depois que todas as solicitações entregues foram canceladas ou concluídas.

Sintaxe

void WdfIoQueueStopSynchronously(
  [in] WDFQUEUE Queue
);

Parâmetros

[in] Queue

Um identificador para um objeto de fila de estrutura.

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

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

Não chame WdfIoQueueStopSynchronously das seguintes funções de retorno de chamada de evento de objeto de fila, independentemente da fila com a qual a função de retorno de chamada de evento está associada:

EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Para obter mais informações sobre o método WdfIoQueueStopSynchronously , consulte Gerenciando filas de E/S.

Exemplos

O exemplo de código a seguir interrompe uma fila especificada.

WdfIoQueueStopSynchronously(WriteQueue);

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfio.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf)

Confira também

WdfIoQueueStart

WdfIoQueueStop