Funzione SetUmsThreadInformation (winbase.h)

  • Articolo

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