Freigeben über


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)

Weitere Informationen

UmsSchedulerProc