SetUmsThreadInformation, fonction (winbase.h)

Article
03/08/2023

Définit des informations de contexte spécifiques à l’application pour le thread de travail de planification en mode utilisateur (UMS) spécifié.

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 SetUmsThreadInformation(
  [in] PUMS_CONTEXT          UmsThread,
  [in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [in] PVOID                 UmsThreadInformation,
  [in] ULONG                 UmsThreadInformationLength
);

Paramètres

[in] UmsThread

Pointeur vers un contexte de thread UMS.

[in] UmsThreadInfoClass

Valeur UMS_THREAD_INFO_CLASS qui spécifie le type d’informations à définir. Ce paramètre doit être UmsThreadUserContext.

[in] UmsThreadInformation

Pointeur vers une mémoire tampon qui contient les informations à définir.

[in] UmsThreadInformationLength

Taille de la mémoire tampon UmsThreadInformation , en octets.

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_INFO_LENGTH_MISMATCH	La taille de la mémoire tampon ne correspond pas à la taille requise pour la classe d’informations spécifiée.
ERROR_INVALID_INFO_CLASS	Le paramètre UmsThreadInfoClass spécifie une classe d’informations qui n’est pas prise en charge.
ERROR_NOT_SUPPORTED	L’UMS n’est pas prise en charge.

Remarques

La fonction SetUmsThreadInformation peut être utilisée pour définir un contexte défini par l’application pour le thread de travail UMS spécifié. Les informations de contexte peuvent se composer de tout ce que l’application peut trouver utile à suivre, comme l’état par planificateur ou par thread de travail. Les structures sous-jacentes des threads de travail UMS sont gérées par le système et ne doivent pas être modifiées directement.

La fonction QueryUmsThreadInformation peut être utilisée pour récupérer d’autres informations exposées sur le thread spécifié, telles que son bloc d’exécution de thread (TEB) et si le thread est suspendu ou arrêté. Les informations qui ne sont pas exposées via QueryUmsThreadInformation doivent être considérées comme réservées.

Configuration requise


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

QueryUmsThreadInformation

Partager via