fonction WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT (wdfio.h)

Article
08/08/2023

[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 les utiliser dans des situations de faible mémoire. Ce nombre doit être supérieur à zéro.

Valeur de retour

None

Remarques

La fonction WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT zéro la structure 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 les 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
                                               );