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) |