QueryUmsThreadInformation, fonction (winbase.h)

Article
03/06/2024

Récupère des informations sur le thread de travail de planification en mode utilisateur (UMS) spécifié.

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 QueryUmsThreadInformation(
  [in]            PUMS_CONTEXT          UmsThread,
  [in]            UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [out]           PVOID                 UmsThreadInformation,
  [in]            ULONG                 UmsThreadInformationLength,
  [out, optional] PULONG                ReturnLength
);

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 à récupérer.

[out] UmsThreadInformation

Pointeur vers une mémoire tampon pour recevoir les informations spécifiées. La taille requise de cette mémoire tampon dépend de la classe d’informations spécifiée.

Si la classe d’informations est UmsThreadContext ou UmsThreadTeb, la mémoire tampon doit être sizeof(PVOID).

Si la classe d’informations est UmsThreadIsSuspended ou UmsThreadIsTerminated, la mémoire tampon doit être sizeof(BOOLEAN).

[in] UmsThreadInformationLength

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

[out, optional] ReturnLength

Pointeur vers une variable ULONG. Lors de la sortie, ce paramètre reçoit le nombre d’octets écrits dans la mémoire tampon UmsThreadInformation .

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 mémoire tampon est trop petite pour les informations demandées.
ERROR_INVALID_INFO_CLASS	La classe d’informations spécifiée n’est pas prise en charge.
ERROR_NOT_SUPPORTED	UMS n’est pas pris en charge.

Remarques

La fonction QueryUmsThreadInformation récupère des informations sur le thread de travail UMS spécifié, telles que son contexte défini par l’application, son bloc d’exécution de thread (TEB) et si le thread est suspendu ou arrêté.

Les structures sous-jacentes pour les threads de travail UMS sont gérées par le système. Les informations qui ne sont pas exposées via QueryUmsThreadInformation doivent être considérées comme réservées.

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

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS

Partager via