CreateUmsThreadContext-Funktion (winbase.h)

Artikel
03/13/2024

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
ERROR_NOT_ENOUGH_MEMORY	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)