fonction WDF_IO_QUEUE_CONFIG_INIT (wdfio.h)

[S’applique à KMDF et UMDF]

La fonction WDF_IO_QUEUE_CONFIG_INIT initialise la structure WDF_IO_QUEUE_CONFIG d’un pilote.

Syntaxe

VOID WDF_IO_QUEUE_CONFIG_INIT(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Paramètres

[out] Config

Pointeur vers la structure WDF_IO_QUEUE_CONFIG du pilote.

[in] DispatchType

Énumérateur WDF_IO_QUEUE_DISPATCH_TYPE qui identifie le type de répartition des demandes pour la file d’attente.

Valeur de retour

Aucun

Remarques

Les pilotes doivent appeler WDF_IO_QUEUE_CONFIG_INIT lors de la création d’une file d’attente d’E/S gérée par l’alimentation qui n’est pas la file d’attente par défaut d’un appareil. La fonction WDF_IO_QUEUE_CONFIG_INIT zéro la structure de WDF_IO_QUEUE_CONFIG spécifiée et définit son membre Size. Il définit également le membre PowerManagedWdfUseDefault et stocke le type de répartition spécifié dans le membre DispatchType.

À compter de KMDF version 1.9, si DispatchType a la valeur WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT définit le membre NumberOfPresentedRequests de la structure sur -1. Cette valeur indique que l’infrastructure peut fournir un nombre illimité de requêtes d’E/S au pilote.

Exemples

L’exemple de code suivant initialise WDF_IO_QUEUE_CONFIG structure, puis appelle WdfIoQueueCreate.

WDF_IO_QUEUE_CONFIG  queueConfig;
NTSTATUS  status = STATUS_SUCCESS;
WDFQUEUE  readQueue;

WDF_IO_QUEUE_CONFIG_INIT(
                         &queueConfig,
                         WdfIoQueueDispatchManual
                         );
status = WdfIoQueueCreate(
                          hDevice,
                          &queueConfig,
                          WDF_NO_OBJECT_ATTRIBUTES,
                          &readQueue
                          );

Spécifications

Voir aussi

WDF_IO_QUEUE_CONFIG

WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE

WDF_IO_QUEUE_DISPATCH_TYPE

WdfIoQueueCreate