KsQueueWorkItem, fonction (ks.h)

Article
02/07/2025

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 n’est associé qu’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 de retour

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

Remarques

Le worker ne peut être sur une file d’attente qu’à un seul endroit. Par conséquent, la mise en file d’attente suivante du worker doit attendre que l’élément de travail ait commencé à s’exécuter. Cette fonction peut être appelée à DISPATCH_LEVEL.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib

Partager via