WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT, fonction (wdfio.h)

Article
08/08/2023

[S’applique à KMDF uniquement]

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

Syntaxe

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_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 tente de réserver pour une utilisation dans des situations de mémoire insuffisante. Ce nombre doit être supérieur à zéro.

Valeur de retour

None

Remarques

La fonction WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT met à 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 ForwardProgressReservedPolicy sur WdfIoForwardProgressReservedPolicyUseExamine.

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 mémoire insuffisante, et que l’infrastructure doit utiliser l’une des demandes réservées dans les situations de mémoire insuffisante uniquement si la demande d’E/S est une opération de pagination.

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