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 nuevos controladores UMDF deben escribirse mediante 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 a 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 al marco después de que se completen todas las solicitudes de E/S pendientes en el controlador. Este parámetro es opcional y se puede NULL.

Valor devuelto

Ninguno

Observaciones

Una llamada a Detener es asincrónica y vuelve inmediatamente al controlador. El controlador recibe una notificación a través del método del IQueueCallbackStateChange interfaz después de que se completen todas las solicitudes pendientes del 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 desde el método de la interfaz a la que apunta el parámetro pStopComplete antes de que el controlador llame a Purgar o Purgar. Si se infringe esta regla, se termina el proceso de host.

El método Stop permite que la cola reciba nuevas solicitudes, incluso si la cola no recibe nuevas solicitudes antes de que el controlador llame a 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 Detener hace que el marco reanude la adición de solicitudes a la cola.

Requisitos

Requisito Valor
fin del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
de la plataforma de destino de Escritorio
versión mínima de UMDF 1.5
encabezado de wudfddi.h (incluya Wudfddi.h)
DLL de WUDFx.dll

Consulte también

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge