Función WdfIoQueueStopAndPurgeSynchronously (wdfio.h)

  • Artículo

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

Consulte también

WdfIoQueueStopAndPurge