função WDF_IO_QUEUE_CONFIG_INIT (wdfio.h)
[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.
Valor de retorno
Nenhum
Observações
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 zera a estrutura de WDF_IO_QUEUE_CONFIG especificada e define seu membro Size. Ele também define o membro do PowerManaged para WdfUseDefault e armazena o tipo de expedição especificado no membro DispatchType.
Começando no 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
);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| versão mínima do UMDF | 2.0 |
| cabeçalho | wdfio.h (inclua Wdf.h) |