funzione WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT (wdfio.h)

Articolo
02/27/2024

[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 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.

[in] EvtIoWdmIrpForForwardProgress

Puntatore alla funzione di callback EvtIoWdmIrpForForwardProgress del driver.

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 imposta il relativo membro Size . Imposta anche i membri TotalForwardProgressRegressRequests eForwardProgressReservePolicySettings.Policy.ExaminePolicy.EvtIoWdmIrpForWardProgress ai valori specificati e imposta 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 chiamare la funzione di callback myIoForwardForwardExamineIrpForwardProgress 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
    );