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 |
|---|---|
|
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) |