fonction WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT (wdfio.h)

[S’applique uniquement à KMDF]

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 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_PAGINGIO_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 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 des situations de mémoire faible, et que l’infrastructure doit utiliser l’une des requêtes réservées pendant les situations de faible mémoire uniquement si la requête 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
    );

Spécifications

Voir aussi

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT

WdfIoQueueAssignForwardProgressPolicy