Função WdfIoQueueStopAndPurgeSynchronously (wdfio.h)

[Aplica-se a KMDF e UMDF]

O método WdfIoQueueStopAndPurgeSynchronously impede que uma fila de E/S forneça novas solicitações de E/S e faz com que a estrutura cancele solicitações não processadas existentes e solicitações canceláveis de propriedade do driver, mas a fila recebe e armazena novas solicitações.

Sintaxe

void WdfIoQueueStopAndPurgeSynchronously(
  [in] WDFQUEUE Queue
);

Parâmetros

[in] Queue

Um identificador para um objeto de fila de estrutura.

Retornar valor

Nenhum

Comentários

Esse método retorna depois que todas as solicitações não processadas e de propriedade do driver (sem incluir solicitações adicionadas à fila depois que essa chamada é feita) são concluídas ou canceladas. Se novas solicitações forem inseridas enquanto WdfIoQueueStopAndPurgeSynchronously estiver em andamento, essas novas solicitações não serão entregues até que o driver chame WdfIoQueueStart.

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

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.11
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 de DDI	ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf)

Confira também

WdfIoQueueStopAndPurge