Funzione SetUmsThreadInformation (winbase.h)

Articolo
03/08/2023

Imposta le informazioni sul contesto specifiche dell'applicazione per il thread di lavoro UMS (User-Mode Scheduling) specificato.

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

Parametri

[in] UmsThread

Puntatore a un contesto di thread UMS.

[in] UmsThreadInfoClass

Valore UMS_THREAD_INFO_CLASS che specifica il tipo di informazioni da impostare. Questo parametro deve essere UmsThreadUserContext.

[in] UmsThreadInformation

Puntatore a un buffer contenente le informazioni da impostare.

[in] UmsThreadInformationLength

Dimensioni del buffer UmsThreadInformation , in byte.

Valore restituito

Se la funzione ha esito positivo, restituisce un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
ERROR_INFO_LENGTH_MISMATCH	Le dimensioni del buffer non corrispondono alle dimensioni necessarie per la classe di informazioni specificata.
ERROR_INVALID_INFO_CLASS	Il parametro UmsThreadInfoClass specifica una classe di informazioni non supportata.
ERROR_NOT_SUPPORTED	UMS non è supportato.

Commenti

La funzione SetUmsThreadInformation può essere usata per impostare un contesto definito dall'applicazione per il thread di lavoro UMS specificato. Le informazioni sul contesto possono essere costituite da qualsiasi elemento che l'applicazione potrebbe trovare utile per tenere traccia, ad esempio per pianificazione o per stato thread di lavoro. Le strutture sottostanti per i thread di lavoro UMS vengono gestite dal sistema e non devono essere modificate direttamente.

La funzione QueryUmsThreadInformation può essere usata per recuperare altre informazioni esposte sul thread specificato, ad esempio il blocco di esecuzione del thread (TEB) e se il thread è sospeso o terminato. Le informazioni non esposte tramite QueryUmsThreadInformation devono essere considerate riservate.

Requisiti


Client minimo supportato	Windows 7 (solo a 64 bit) [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [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)

Vedi anche

QueryUmsThreadInformation

Condividi tramite