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.
Valor de retorno
Nenhum
Observações
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 as chamadas de driver WdfIoQueueStart.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Requisitos
| Requisito | Valor |
|---|---|
| da 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) |