Compartir a través de

Método IWDFIoQueue::D rain (wudfddi.h)

  • Artículo

[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 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 se puede NULL.

Valor devuelto

Ninguno

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 llamó anteriormente a Drain, debe esperar la notificación desde el método de la interfaz a la que apunta el parámetro pDrainComplete antes de que el controlador llame a Stop o Purge. Si se infringe esta regla, se termina el proceso de host.

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

IWDFIoQueue::Stop