Función WdfIoQueueStopAndPurgeSynchronously (wdfio.h)
[Se aplica a KMDF y UMDF]
El método WdfIoQueueStopAndPurgeSynchronously impide que una cola de E/S entregue nuevas solicitudes de E/S y hace que el marco cancele las solicitudes no procesadas existentes y las solicitudes cancelables propiedad del controlador, pero la cola recibe y almacena nuevas solicitudes.
Sintaxis
void WdfIoQueueStopAndPurgeSynchronously(
[in] WDFQUEUE Queue
);
Parámetros
[in] Queue
Identificador de un objeto de cola de marco.
Valor devuelto
None
Observaciones
Este método devuelve después de que todas las solicitudes no procesadas y propiedad del controlador (no incluidas las solicitudes agregadas a la cola después de realizar esta llamada) se completen o cancelen. Si se insertan nuevas solicitudes mientras WdfIoQueueStopAndPurgeSynchronously está en curso, estas nuevas solicitudes no se entregan hasta que el controlador llama a WdfIoQueueStart.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.11 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfio.h (incluya Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |