função WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT (wdfio.h)
[Aplica-se somente ao KMDF]
A função WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT inicializa a estrutura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY de um driver.
Sintaxe
void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT(
[out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Policy,
[in] ULONG TotalForwardProgressRequests
);
Parâmetros
[out] Policy
Um ponteiro para a estrutura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY do driver.
[in] TotalForwardProgressRequests
O número de objetos de solicitação que a estrutura tentará reservar para uso em situações de memória baixa. Esse número deve ser maior que zero.
Valor de retorno
Nenhum
Observações
A função WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT zera a estrutura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY especificada e define seu membro tamanho. Ele também define o membro TotalForwardProgressRequests da estrutura como o valor especificado e define o membro ForwardProgressReservedPolicy para WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest.
Exemplos
O exemplo de código a seguir inicializa uma estrutura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY e chama WdfIoQueueAssignForwardProgressPolicy. No exemplo, o driver está especificando que a estrutura deve alocar e reservar 10 objetos de solicitação para situações de baixa memória.
#define MAX_RESERVED_REQUESTS 10
WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;
WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT(
&queueForwardProgressPolicy,
MAX_RESERVED_REQUESTS
);
status = WdfIoQueueAssignForwardProgressPolicy(
readQueue,
&queueForwardProgressPolicy
);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.9 |
| cabeçalho | wdfio.h (inclua Wdf.h) |
Consulte também
WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT