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.
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
);
Requisitos
Requisito | Valor |
---|---|
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) |