Função WdfIoQueueStopSynchronously (wdfio.h)
[Aplica-se a KMDF e UMDF]
O método WdfIoQueueStopSynchronously impede que uma fila de E/S forneça 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.
Valor de retorno
Nenhum
Observações
Uma verificação de bug ocorre se o driver fornece 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:
método EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Para obter mais informações sobre o método WdfIoQueueStopStopSynchronously, consulte Managing I/O Queues.
Exemplos
O exemplo de código a seguir interrompe uma fila especificada.
WdfIoQueueStopSynchronously(WriteQueue);
Requisitos
| Requisito | Valor |
|---|---|
| da 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 de DDI | ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |