Funzione UmsThreadYield (winbase.h)
Restituisce il controllo al thread di pianificazione in modalità utente (UMS) in cui è in esecuzione il thread di lavoro UMS chiamante.
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 UmsThreadYield(
[in] PVOID SchedulerParam
);
Parametri
[in] SchedulerParam
Parametro da passare alla funzione UmsSchedulerProc del thread dell'utilità di pianificazione.
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.
Commenti
Un thread di lavoro UMS chiama la funzione UmsThreadYield per restituire in modo collaborativo il controllo al thread dell'utilità di pianificazione UMS in cui è in esecuzione il thread di lavoro. Se un thread di lavoro UMS non chiama mai UmsThreadYield, il thread di lavoro viene eseguito fino a quando non blocca o viene terminato.
Quando il controllo passa al thread dell'utilità di pianificazione UMS, il sistema chiama la funzione del punto di ingresso dell'utilità di pianificazione associata con il motivo UmsSchedulerThreadYield e il parametro ScheduleParam specificato dal thread di lavoro nella chiamata UmsThreadYield .
L'utilità di pianificazione dell'applicazione è responsabile della riprogrammazione del thread di lavoro.
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) |