función WDF_IO_QUEUE_CONFIG_INIT (wdfio.h)

Artículo
02/27/2024

[Se aplica a KMDF y UMDF]

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

Sintaxis

void WDF_IO_QUEUE_CONFIG_INIT(
  [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

None

Observaciones

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

A partir de la versión 1.9 de KMDF, si DispatchType está establecido en WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT 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.

Ejemplos

En el ejemplo de código siguiente se inicializa WDF_IO_QUEUE_CONFIG estructura y, a continuación, se llama a WdfIoQueueCreate.

WDF_IO_QUEUE_CONFIG  queueConfig;
NTSTATUS  status = STATUS_SUCCESS;
WDFQUEUE  readQueue;

WDF_IO_QUEUE_CONFIG_INIT(
                         &queueConfig,
                         WdfIoQueueDispatchManual
                         );
status = WdfIoQueueCreate(
                          hDevice,
                          &queueConfig,
                          WDF_NO_OBJECT_ATTRIBUTES,
                          &readQueue
                          );