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)

Vedi anche

UmsSchedulerProc