KsQueueWorkItem, fonction (ks.h)

Article
02/29/2024

La fonction KsQueueWorkItem met en file d’attente l’élément de travail spécifié avec un worker créé par la fonction KsRegisterWorker .

Syntaxe

KSDDKAPI NTSTATUS KsQueueWorkItem(
  [in] PKSWORKER        Worker,
  [in] PWORK_QUEUE_ITEM WorkItem
);

Paramètres

[in] Worker

Spécifie le worker précédemment alloué.

[in] WorkItem

Spécifie l’élément de travail initialisé à mettre en file d’attente. Cet élément de travail est uniquement associé au worker tant que le worker se trouve dans une file d’attente. L’élément de travail doit avoir été initialisé par IoAllocateWorkItem.

Valeur retournée

La fonction KsQueueWorkItem retourne STATUS_SUCCESS si l’élément de travail a été mis en file d’attente, ou en cas d’échec, la fonction retourne une erreur lors de la tentative de création d’un worker si aucun thread n’est actuellement disponible.

Remarques

Le worker ne peut se trouver dans une file d’attente qu’à un seul emplacement. La mise en file d’attente ultérieure du worker doit donc attendre que l’élément de travail ait commencé à s’exécuter. Cette fonction peut être appelée au DISPATCH_LEVEL.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib

Partager via