Funzione GetUmsSystemThreadInformation (winbase.h)

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.

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