Compartir a través de


Método IWDFIoQueue::Stop (wudfddi.h)

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método Stop impide que una cola de E/S entregue solicitudes de E/S, pero la cola recibe y almacena nuevas solicitudes.

Sintaxis

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

Parámetros

[in, optional] pStopComplete

Puntero a la interfaz IQueueCallbackStateChange cuyo método llama el marco después de que se completen todas las solicitudes de E/S pendientes en el controlador. Este parámetro es opcional y puede ser NULL.

Valor devuelto

None

Observaciones

Una llamada a Stop es asincrónica y vuelve inmediatamente al controlador. El controlador se notifica a través del método de la interfaz IQueueCallbackStateChange proporcionada después de que se completen todas las solicitudes pendientes en el controlador.

El controlador debe asegurarse de que solo uno de los métodos siguientes está en curso en un momento dado:

Por ejemplo, si el controlador llamó anteriormente a Stop, debe esperar la notificación del método de la interfaz a la que apunta el parámetro pStopComplete antes de que el controlador llame a Drain o Purge. Infringir esta regla da como resultado la finalización del proceso de host.

El método Stop permite a la cola recibir nuevas solicitudes, incluso si la cola no recibió nuevas solicitudes antes de que el controlador llamara Stop. Por ejemplo, un controlador podría llamar a IWDFIoQueue::D rain, lo que hace que el marco deje de agregar nuevas solicitudes de E/S a la cola. La llamada posterior del controlador de Stop hace que el marco reanude la adición de solicitudes a la cola.

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.5
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge