Compartir a través de


Método IWDFIoQueue::D rain (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 Drain dirige la cola para rechazar nuevas solicitudes de E/S entrantes y permitir que las solicitudes ya en cola se entreguen al controlador para su procesamiento.

Sintaxis

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

Parámetros

[in, optional] pDrainComplete

Puntero a la interfaz IQueueCallbackStateChange cuyo método llama al marco para entregar el estado de la cola al controlador. El marco llama al método una vez completadas o canceladas todas las solicitudes y la cola está vacía. Este parámetro es opcional y puede ser NULL.

Valor devuelto

None

Observaciones

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

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

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::P urge

IWDFIoQueue::Stop