WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY structure (wdfio.h)

[S’applique à KMDF uniquement]

La structure WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY contient des informations fournies par le pilote que l’infrastructure utilise pour permettre une progression garantie pour une file d’attente d’E/S.

Syntaxe

typedef struct _WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY {
  ULONG                                              Size;
  ULONG                                              TotalForwardProgressRequests;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY            ForwardProgressReservedPolicy;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS   ForwardProgressReservePolicySettings;
  PFN_WDF_IO_ALLOCATE_RESOURCES_FOR_RESERVED_REQUEST EvtIoAllocateResourcesForReservedRequest;
  PFN_WDF_IO_ALLOCATE_REQUEST_RESOURCES              EvtIoAllocateRequestResources;
} WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY, *PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY;

Membres

Size

Longueur, en octets, de cette structure.

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.

ForwardProgressReservedPolicy

Valeur de type WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY qui spécifie comment l’infrastructure alloue des objets de requête dans les situations de mémoire insuffisante.

ForwardProgressReservePolicySettings

Structure WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS qui contient des valeurs supplémentaires spécifiques à la stratégie spécifiée par le membre ForwardProgressReservedPolicy . Ce membre doit être NULL , sauf si le pilote fournit une fonction de rappel EvtIoWdmIrpForForwardProgress .

EvtIoAllocateResourcesForReservedRequest

Pointeur vers la fonction de rappel EvtIoAllocateResourcesForReservedRequest spécifique à la file d’attente du pilote, ou NULL.

EvtIoAllocateRequestResources

Pointeur vers la fonction de rappel EvtIoAllocateRequestResources spécifique à la file d’attente du pilote, ou NULL.

Remarques

La structure WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY est utilisée comme entrée de la méthode WdfIoQueueAssignForwardProgressPolicy .

Les pilotes doivent initialiser la structure WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY en appelant WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT, WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT ou WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT avant d’appeler WdfIoQueueAssignForwardProgressPolicy.

Configuration requise

Condition requise	Valeur
Version KMDF minimale	1,9
En-tête	wdfio.h (inclure Wdf.h)