funzione WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT (wdfio.h)

Articolo
03/22/2025

[Si applica solo a KMDF]

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

Sintassi

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY   Policy,
  [in]  ULONG                                   TotalForwardProgressRequests,
  [in]  PFN_WDF_IO_WDM_IRP_FOR_FORWARD_PROGRESS EvtIoWdmIrpForForwardProgress
);

Parametri

[out] Policy

Puntatore alla struttura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY del conducente.

[in] TotalForwardProgressRequests

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

[in] EvtIoWdmIrpForForwardProgress

Puntatore alla evtIoWdmIrpForForwardProgress del driver funzione di callback.

Valore restituito

Nessuno

Osservazioni:

La funzione WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT zero la struttura di WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY specificata e ne imposta il membro Size. Imposta inoltre il TotalForwardProgressRequests eForwardProgressReservePolicySettings.Policy.ExaminePolicy.EvtIoWdmIrpForForwardProgress membri ai valori specificati, e imposta il membro ForwardProgressReservedPolicy su WdfIoForwardProgressReservedPolicyUseExamine.

Esempi

Nell'esempio di codice seguente viene inizializzata una struttura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY e quindi viene chiamato WdfIoQueueAssignForwardProgressPolicy. Nell'esempio, il driver specifica che il framework deve allocare e riservare 10 oggetti richiesta per situazioni di memoria insufficiente e che il framework deve chiamare il driver MyIoForwardExamineIrpForWardProgress funzione di callback prima di usare uno degli oggetti richiesta riservati.

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT(
    &queueForwardProgressPolicy,
    MAX_RESERVED_REQUESTS,
    MyIoForwardExamineIrpForForwardProgress
    );
status = WdfIoQueueAssignForwardProgressPolicy(
    readQueue,
    &queueForwardProgressPolicy
    );