fonction WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE (wdfio.h)

2025-03-22

[S’applique à KMDF et UMDF]

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

Syntaxe

void WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
  [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_DEFAULT_QUEUE lors de la création d’une file d’attente d’E/S gérée par l’alimentation qui est la file d’attente par défaut d’un appareil. La fonction WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE zéro la structure de WDF_IO_QUEUE_CONFIG spécifiée et définit son membre Size. Il définit également le membre PowerManaged sur WdfUseDefault, définit le membre DefaultQueue sur TRUEet 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_DEFAULT_QUEUE définit les 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.

Pour obtenir un exemple de code qui utilise WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE, consultez WdfIoQueueCreate.