funzione WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT (wdfio.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

La funzione WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT inizializza la struttura di WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY di un driver.

Sintassi

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Policy,
  [in]  ULONG                                 TotalForwardProgressRequests
);

Parametri

[out] Policy

Puntatore alla struttura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY del driver.

[in] TotalForwardProgressRequests

Numero di oggetti richiesta che il framework tenterà di riservare per l'uso in situazioni di memoria ridotta. Questo numero deve essere maggiore di zero.

Valore restituito

nessuno

Osservazioni

La funzione WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT zero la struttura di WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY specificata e imposta il relativo membro Size. Imposta anche il membro TotalForwardProgressRequests del valore specificato e imposta il membro ForwardProgressReservedPolicy su WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest.

Esempio

L'esempio di codice seguente inizializza una struttura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY e quindi chiama WdfIoQueueAssignForwardProgressPolicy. Nell'esempio, il driver specifica che il framework deve allocare e riservare 10 oggetti richiesta per situazioni di memoria ridotta.

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