GetUmsSystemThreadInformation, fonction (winbase.h)

Article
03/06/2024

Interroge si le thread spécifié est un thread de planificateur UMS, un thread de travail UMS ou un thread non-UMS.

Avertissement

Depuis 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 GetUmsSystemThreadInformation(
  [in]      HANDLE                         ThreadHandle,
  [in, out] PUMS_SYSTEM_THREAD_INFORMATION SystemThreadInfo
);

Paramètres

[in] ThreadHandle

Handle pour un thread. Le handle de thread doit avoir le droit d’accès THREAD_QUERY_INFORMATION. Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

[in, out] SystemThreadInfo

Pointeur vers une structure UMS_SYSTEM_THREAD_INFORMATION qui reçoit des informations sur le thread spécifié.

L’appelant doit initialiser le membre avant d’appeler UmsVersion .

Valeur retournée

Si la fonction échoue, la valeur de retour est égale à zéro.

Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction GetUmsSystemThreadInformation est destinée à être utilisée dans les débogueurs, les outils de dépannage et les applications de profilage. Par exemple, le suivi isolé des threads ou les instructions pas à pas uniques peuvent impliquer la suspension de tous les autres threads du processus. Toutefois, si le thread à tracer est un thread de travail UMS, la suspension des threads du planificateur UMS peut entraîner un interblocage, car un thread de travail UMS nécessite l’intervention d’un thread de planificateur UMS pour s’exécuter. Un débogueur peut appeler GetUmsSystemThreadInformation pour chaque thread qu’il peut suspendre pour déterminer le type de thread, puis le suspendre ou non en fonction des besoins du code débogué.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 avec SP1 [applications de bureau uniquement],Windows 7 (64 bits uniquement) et Windows Server 2008 R2 avec KB977165 installés
Serveur minimal pris en charge	Windows Server 2008 R2 avec SP1 [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)

Share via