funzione WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT (wdfio.h)

Articolo
03/05/2024

[Si applica solo a KMDF]

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

Sintassi

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_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_PAGINGIO_INIT zero la struttura di WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY specificata e imposta il relativo membro Size . Imposta anche il membro ForwardProgressReservedPolicy su WdfIoForwardProgressReservedPolicyUseExamine.

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 di richiesta per situazioni di memoria ridotta e che il framework deve usare una delle richieste riservate durante situazioni di memoria ridotta solo se la richiesta di I/O è un'operazione di paging.

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT(
    &queueForwardProgressPolicy,
    MAX_RESERVED_REQUESTS
    );
status = WdfIoQueueAssignForwardProgressPolicy(
    readQueue,
    &queueForwardProgressPolicy
    );