Funzione CreateUmsThreadContext (winbase.h)
Crea un contesto di pianificazione in modalità utente (UMS) per rappresentare un thread di lavoro 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 CreateUmsThreadContext(
[out] PUMS_CONTEXT *lpUmsThread
);
Parametri
[out] lpUmsThread
Variabile PUMS_CONTEXT. In output, questo parametro riceve un puntatore a un contesto di thread UMS.
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 |
|---|---|
|
Memoria insufficiente disponibile per creare il contesto del thread UMS. |
Commenti
Un contesto di thread UMS rappresenta lo stato di un thread di lavoro UMS. I contesti del thread vengono usati per specificare thread di lavoro UMS nelle chiamate di funzione.
Viene creato un thread di lavoro UMS chiamando la funzione CreateRemoteThreadEx dopo aver usato InitializeProcThreadAttributeList e UpdateProcThreadAttribute per preparare un elenco di attributi UMS per il thread.
Le strutture sottostanti per un contesto di thread UMS sono gestite dal sistema e non devono essere modificate direttamente. Per ottenere e impostare informazioni su un thread di lavoro UMS, usare le funzioni QueryUmsThreadInformation e SetUmsThreadInformation .
Dopo che un thread di lavoro UMS termina, il contesto del thread deve essere rilasciato chiamando DeleteUmsThreadContext.
Requisiti
| Requisito | Valore |
|---|---|
| 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) |