CreateUmsThreadContext-Funktion (winbase.h)
Erstellt einen Ums-Threadkontext (User-Mode Scheduling) zur Darstellung eines UMS-Workerthreads.
Warnung
Ab Windows 11 wird die Planung im Benutzermodus nicht unterstützt. Alle Aufrufe schlagen mit dem Fehler ERROR_NOT_SUPPORTEDfehl.
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, gibt sie einen Wert ohne Zero zurück.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Zum Erstellen des UMS-Threadkontexts steht nicht genügend Arbeitsspeicher zur Verfügung. |
Hinweise
Ein UMS-Threadkontext stellt den Zustand eines UMS-Workerthreads dar. Threadkontexte werden verwendet, um UMS-Workerthreads in Funktionsaufrufen anzugeben.
Ein UMS-Workerthread wird erstellt, indem die CreateRemoteThreadEx-Funktion aufgerufen wird, nachdem InitializeProcThreadAttributeList und UpdateProcThreadAttribute verwendet wurden, um eine Liste mit UMS-Attributen 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 sein Threadkontext durch Aufrufen von DeleteUmsThreadContext freigegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |
| APIs | api-ms-win-core-ums-l1-1-0 (in Windows 7 eingeführt) |