KsRegisterWorker, fonction (ks.h)

  • Article

La fonction KsRegisterWorker gère les clients qui s’inscrivent pour l’utilisation d’un thread. La fonction peut créer un thread de la priorité spécifiée s’il n’existe actuellement aucun thread gratuit disponible. Cela doit être mis en correspondance par un KsUnregisterWorker correspondant lorsque l’utilisation du thread est terminée. La fonction ne peut être appelée qu’à PASSIVE_LEVEL.

typedef PVOID PKSWORKER;

Les routines de travail fonctionnent sur des objets PKSWORKER opaques créés pour chaque élément de travail mis en file d’attente à la fois.

Syntaxe

KSDDKAPI NTSTATUS KsRegisterWorker(
  [in]  WORK_QUEUE_TYPE WorkQueueType,
  [out] PKSWORKER       *Worker
);

Paramètres

[in] WorkQueueType

Spécifie la priorité du thread à créer. Il s’agit généralement de CriticalWorkQueue, DelayedWorkQueue ou HyperCriticalWorkQueue.

[out] Worker

Emplacement où placer le contexte opaque qui doit être utilisé lors de la planification d’un élément de travail. Il contient le type de file d’attente et est utilisé pour synchroniser l’achèvement des éléments de travail.

Valeur retournée

La fonction KsRegisterWorker retourne STATUS_SUCCESS si un worker a été initialisé, ou en cas d’échec, la fonction retourne une erreur de thread ou de paramètre.

Configuration requise

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