Función WdfIoQueueStopSynchronously (wdfio.h)
[Se aplica a KMDF y UMDF]
El método WdfIoQueueStopSynchronously impide que una cola de E/S entregue solicitudes de E/S, pero la cola recibe y almacena nuevas solicitudes. El método devuelve una vez canceladas o completadas todas las solicitudes entregadas.
Sintaxis
void WdfIoQueueStopSynchronously(
[in] WDFQUEUE Queue
);
Parámetros
[in] Queue
Identificador de un objeto de cola de marco.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
El método WdfIoQueueStopSynchronously permite que la cola reciba nuevas solicitudes, aunque la cola no reciba nuevas solicitudes antes de que el controlador llamado WdfIoQueueStopSynchronously. Por ejemplo, un controlador podría llamar a WdfIoQueueDrain, lo que hace que el marco deje de agregar nuevas solicitudes de E/S a la cola. La llamada posterior del controlador de WdfIoQueueStopSynchronous hace que el marco reanude la adición de solicitudes a la cola.
No llame a WdfIoQueueStopSynchronousmente desde las siguientes funciones de devolución de llamada de eventos de objeto de cola, independientemente de la cola con la que está asociada la función de devolución de llamada de evento:
EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Para obtener más información sobre el método WdfIoQueueStopSynchronously , vea Administración de colas de E/S.
Ejemplos
En el ejemplo de código siguiente se detiene una cola especificada.
WdfIoQueueStopSynchronously(WriteQueue);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| 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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |