Fonction CreateUmsThreadContext (winbase.h)

Article
03/03/2024

Crée un contexte de thread de planification en mode utilisateur (UMS) pour représenter un thread de travail UMS.

Avertissement

À partir de Windows 11, la planification en mode utilisateur n’est pas prise en charge. Tous les appels échouent avec l’erreur ERROR_NOT_SUPPORTED.

Syntaxe

BOOL CreateUmsThreadContext(
  [out] PUMS_CONTEXT *lpUmsThread
);

Paramètres

[out] lpUmsThread

Variable PUMS_CONTEXT. Lors de la sortie, ce paramètre reçoit un pointeur vers un contexte de thread UMS.

Valeur retournée

Si la fonction réussit, elle retourne une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Les valeurs d’erreur possibles sont les suivantes.

Code de retour	Description
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante pour créer le contexte de thread UMS.

Remarques

Un contexte de thread UMS représente l’état d’un thread worker UMS. Les contextes de thread sont utilisés pour spécifier des threads de travail UMS dans les appels de fonction.

Un thread de travail UMS est créé en appelant la fonction CreateRemoteThreadEx après avoir utilisé InitializeProcThreadAttributeList et UpdateProcThreadAttribute pour préparer une liste d’attributs UMS pour le thread.

Les structures sous-jacentes d’un contexte de thread UMS sont gérées par le système et ne doivent pas être modifiées directement. Pour obtenir et définir des informations sur un thread de travail UMS, utilisez les fonctions QueryUmsThreadInformation et SetUmsThreadInformation .

Après l’arrêt d’un thread de travail UMS, son contexte de thread doit être libéré en appelant DeleteUmsThreadContext.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 (64 bits uniquement) [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll
Ensemble d’API	api-ms-win-core-ums-l1-1-0 (introduit dans Windows 7)