fonction WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT (wdfio.h)

Article
03/22/2025

[S’applique uniquement à KMDF]

La fonction WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT initialise la structure WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY d’un pilote.

Syntaxe

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

Paramètres

[out] Policy

Pointeur vers la structure WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY du pilote.

[in] TotalForwardProgressRequests

Nombre d’objets de requête que l’infrastructure tentera de réserver pour une utilisation dans des situations de mémoire faible. Ce nombre doit être supérieur à zéro.

Valeur de retour

Aucun

Remarques

La fonction WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT zéro la structure de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY spécifiée et définit son membre Size. Il définit également le membre TotalForwardProgressRequests de la structure sur la valeur spécifiée et définit le membre ForwardProgressReservedPolicy sur WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest.

Exemples

L’exemple de code suivant initialise une structure WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY, puis appelle WdfIoQueueAssignForwardProgressPolicy. Dans l’exemple, le pilote spécifie que l’infrastructure doit allouer et réserver 10 objets de requête pour des situations de faible mémoire.

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