UmsThreadYield-Funktion (winbase.h)
Gibt dem UMS-Planerthread (User-Mode Scheduling) die Steuerung zurück, auf dem der aufrufende UMS-Workerthread ausgeführt wird.
Warnung
Ab Windows 11 wird die Planung im Benutzermodus nicht unterstützt. Alle Aufrufe schlagen mit dem Fehler ERROR_NOT_SUPPORTEDfehl.
Syntax
BOOL UmsThreadYield(
[in] PVOID SchedulerParam
);
Parameter
[in] SchedulerParam
Ein Parameter, der an die UmsSchedulerProc-Funktion des Planerthreads übergeben werden soll.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Wert ungleich null zurückgegeben.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Ein UMS-Workerthreadthread ruft die UmsThreadYield-Funktion auf, um dem UMS-Planerthread, auf dem der Workerthread ausgeführt wird, kooperativ die Kontrolle zu übergeben. Wenn ein UMS-Workerthread nie UmsThreadYield aufruft, wird der Arbeitsthread ausgeführt, bis er entweder blockiert oder beendet wird.
Wenn die Steuerung zum UMS-Planerthread wechselt, ruft das System die zugeordnete Scheduler-Einstiegspunktfunktion mit dem Grund UmsSchedulerThreadYield und dem ScheduleParam-Parameter auf, der vom Workerthreadyield im UmsThreadYield-Aufruf angegeben wird.
Der Scheduler der Anwendung ist für die Neuplanung des Workerthreads verantwortlich.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 (nur 64-Bit) [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |
| APIs | api-ms-win-core-ums-l1-1-0 (eingeführt in Windows 7) |