CreateUmsThreadContext-Funktion (winbase.h)
Erstellt einen UMS-Threadkontext (User Mode Scheduling), um einen UMS-Workerthread darzustellen.
Warnung
Ab Windows 11 wird die Planung des Benutzermodus nicht unterstützt. Alle Aufrufe schlagen mit dem Fehler fehl ERROR_NOT_SUPPORTED.
Syntax
BOOL CreateUmsThreadContext(
[out] PUMS_CONTEXT *lpUmsThread
);
Parameter
[out] lpUmsThread
Eine PUMS_CONTEXT Variable. Bei der Ausgabe empfängt dieser Parameter einen Zeiger auf einen UMS-Threadkontext.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Wert ohne Zero zurückgegeben.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehlerwerte umfassen Folgendes.
| Rückgabecode | Beschreibung |
|---|---|
|
Nicht genügend Arbeitsspeicher ist verfügbar, um den UMS-Threadkontext zu erstellen. |
Bemerkungen
Ein UMS-Threadkontext stellt den Status eines UMS-Workerthreads dar. Threadkontexte werden verwendet, um UMS-Arbeitsthreads in Funktionsaufrufen anzugeben.
Ein UMS-WorkerthreadthreadthreadEx wird durch Aufrufen der CreateRemoteThreadEx-Funktion erstellt, nachdem InitializeProcThreadAttributeList und UpdateProcThreadAttribute verwendet wurden, um eine Liste der UMS-Attribute für den Thread vorzubereiten.
Die zugrunde liegenden Strukturen für einen UMS-Threadkontext werden vom System verwaltet und sollten nicht direkt geändert werden. Um Informationen zu einem UMS-Workerthread abzurufen und festzulegen, verwenden Sie die Funktionen QueryUmsThreadInformation und SetUmsThreadInformation .
Nachdem ein UMS-Workerthread beendet wurde, sollte der Threadkontext durch Aufrufen von DeleteUmsThreadContext freigegeben werden.
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 (schließen Sie Windows.h ein) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |
| APIs | api-ms-win-core-ums-l1-1-0 (eingeführt in Windows 7) |