Partager via


Fonction CreateUmsThreadContext (winbase.h)

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)

Voir aussi

CreateRemoteThreadEx

DeleteUmsThreadContext

InitializeProcThreadAttributeList

QueryUmsThreadInformation

SetUmsThreadInformation

UpdateProcThreadAttribute