função WDF_IO_QUEUE_CONFIG_INIT (wdfio.h)

Artigo
08/08/2023

[Aplica-se a KMDF e UMDF]

A função WDF_IO_QUEUE_CONFIG_INIT inicializa a estrutura de WDF_IO_QUEUE_CONFIG de um driver.

Sintaxe

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

Parâmetros

[out] Config

Um ponteiro para a estrutura de WDF_IO_QUEUE_CONFIG do driver.

[in] DispatchType

Um enumerador WDF_IO_QUEUE_DISPATCH_TYPE que identifica o tipo de expedição de solicitação para a fila.

Retornar valor

Nenhum

Comentários

Os drivers devem chamar WDF_IO_QUEUE_CONFIG_INIT ao criar uma fila de E/S gerenciada por energia que não seja a fila padrão de um dispositivo. A função WDF_IO_QUEUE_CONFIG_INIT zerá a estrutura de WDF_IO_QUEUE_CONFIG especificada e definirá seu membro Size . Ele também define o membro PowerManaged como WdfUseDefault e armazena o tipo de expedição especificado no membro DispatchType .

A partir do KMDF versão 1.9, se DispatchType estiver definido como WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT definirá o membro NumberOfPresentedRequests da estrutura como -1. Esse valor indica que a estrutura pode fornecer um número ilimitado de solicitações de E/S ao driver.

Exemplos

O exemplo de código a seguir inicializa WDF_IO_QUEUE_CONFIG estrutura e chama 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
                          );