Funzione GetUmsSystemThreadInformation (winbase.h)

Articolo
03/13/2024

Esegue query sul fatto che il thread specificato sia un thread dell'utilità di pianificazione UMS, un thread di lavoro UMS o un thread non UMS.

Avviso

A partire da Windows 11, la pianificazione in modalità utente non è supportata. Tutte le chiamate hanno esito negativo con l'errore ERROR_NOT_SUPPORTED.

Sintassi

BOOL GetUmsSystemThreadInformation(
  [in]      HANDLE                         ThreadHandle,
  [in, out] PUMS_SYSTEM_THREAD_INFORMATION SystemThreadInfo
);

Parametri

[in] ThreadHandle

Handle a un thread. L'handle del thread deve avere il diritto di accesso THREAD_QUERY_INFORMATION. Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.

[in, out] SystemThreadInfo

Puntatore a una struttura UMS_SYSTEM_THREAD_INFORMATION che riceve informazioni sul thread specificato.

Il chiamante deve inizializzare il UmsVersion membro prima di chiamare.

Valore restituito

Se la funzione ha esito negativo, il valore restituito è zero.

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetUmsSystemThreadInformation è destinata all'uso nei debugger, negli strumenti di risoluzione dei problemi e nelle applicazioni di profilatura. Ad esempio, la traccia isolata dal thread o l'esecuzione singola delle istruzioni potrebbero comportare la sospensione di tutti gli altri thread nel processo. Tuttavia, se il thread da tracciare è un thread di lavoro UMS, la sospensione dei thread dell'utilità di pianificazione UMS potrebbe causare un deadlock perché un thread di lavoro UMS richiede l'intervento di un thread dell'utilità di pianificazione UMS per l'esecuzione. Un debugger può chiamare GetUmsSystemThreadInformation per ogni thread che potrebbe sospendere per determinare il tipo di thread e quindi sospenderlo o meno come necessario per il debug del codice.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 con SP1 [solo app desktop],Windows 7 (solo a 64 bit) e Windows Server 2008 R2 con KB977165 installato
Server minimo supportato	Windows Server 2008 R2 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll
Set di API	api-ms-win-core-ums-l1-1-0 (introdotta in Windows 7)

Share via