função WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT (wdfio.h)

Artigo
02/27/2024

[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 insuficiente. Esse número deve ser maior que zero.

Retornar valor

Nenhum

Comentários

A função WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT zeros a estrutura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY especificada e define seu membro Size . Ele também define o membro TotalForwardProgressRequests da estrutura como o valor especificado e define o membro ForwardProgressReservedPolicy como WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest.

Exemplos

O exemplo de código a seguir inicializa uma estrutura 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 memória insuficiente.

#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
                                               );