WDF_IO_QUEUE_CONFIG_INIT, fonction (wdfio.h)

Article
02/29/2024

[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 distribution des demandes pour la file d’attente.

Valeur de retour

None

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 met à 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 et stocke le type de distribution spécifié dans le membre DispatchType .

À compter de KMDF version 1.9, si DispatchType est défini sur 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 demandes 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
                          );