función WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE (wdfio.h)

2025-03-22

[Se aplica a KMDF y UMDF]

La función WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE inicializa la estructura WDF_IO_QUEUE_CONFIG de un controlador.

Sintaxis

void WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Parámetros

[out] Config

Puntero a la estructura WDF_IO_QUEUE_CONFIG del controlador.

[in] DispatchType

Enumerador WDF_IO_QUEUE_DISPATCH_TYPE que identifica el tipo de envío de solicitudes para la cola.

Valor devuelto

Ninguno

Observaciones

Los controladores deben llamar a WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE al crear una cola de E/S administrada por energía que sea la cola predeterminada de un dispositivo. La función WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE cero la estructura de WDF_IO_QUEUE_CONFIG especificada y establece su miembro Size. También establece el miembro PowerManaged en WdfUseDefault, establece el miembro DefaultQueue en TRUEy almacena el tipo de distribución especificado en el miembro DispatchType de.

A partir de la versión 1.9 de KMDF, si DispatchType está establecido en WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE establece el miembro NumberOfPresentedRequests de la estructura en -1. Este valor indica que el marco puede entregar un número ilimitado de solicitudes de E/S al controlador.

Para obtener un ejemplo de código que usa WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE, vea WdfIoQueueCreate.