fonction WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE (wdfio.h)

Article
02/27/2024

[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

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

Valeur de retour

None

Remarques

Les pilotes doivent appeler WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE lors de la création d’une file 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 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 TRUE 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_DEFAULT_QUEUE définit le membre NumberOfPresentedRequests de la structure sur -1. Cette valeur indique que l’infrastructure peut fournir un nombre illimité de demandes d’E/S au pilote.

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