QueryUmsThreadInformation-Funktion (winbase.h)

Artikel
08/27/2023

Ruft Informationen zum angegebenen UMS-Workerthread (User Mode Scheduling) ab.

Warnung

Ab Windows 11 wird die Planung im Benutzermodus nicht unterstützt. Alle Aufrufe schlagen mit dem Fehler ERROR_NOT_SUPPORTEDfehl.

Syntax

BOOL QueryUmsThreadInformation(
  [in]            PUMS_CONTEXT          UmsThread,
  [in]            UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [out]           PVOID                 UmsThreadInformation,
  [in]            ULONG                 UmsThreadInformationLength,
  [out, optional] PULONG                ReturnLength
);

Parameter

[in] UmsThread

Ein Zeiger auf einen UMS-Threadkontext.

[in] UmsThreadInfoClass

Ein UMS_THREAD_INFO_CLASS Wert, der die Art der abzurufenden Informationen angibt.

[out] UmsThreadInformation

Ein Zeiger auf einen Puffer zum Empfangen der angegebenen Informationen. Die erforderliche Größe dieses Puffers hängt von der angegebenen Informationsklasse ab.

Wenn die Informationsklasse UmsThreadContext oder UmsThreadTeb ist, muss der Puffer sein sizeof(PVOID).

Wenn die Informationsklasse UmsThreadIsSuspended oder UmsThreadIsTerminated ist, muss der Puffer sein sizeof(BOOLEAN).

[in] UmsThreadInformationLength

Die Größe des UmsThreadInformation-Puffers in Bytes.

[out, optional] ReturnLength

Ein Zeiger auf eine ULONG-Variable. Bei der Ausgabe empfängt dieser Parameter die Anzahl der Bytes, die in den UmsThreadInformation-Puffer geschrieben werden.

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. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
ERROR_INFO_LENGTH_MISMATCH	Der Puffer ist für die angeforderten Informationen zu klein.
ERROR_INVALID_INFO_CLASS	Die angegebene Informationsklasse wird nicht unterstützt.
ERROR_NOT_SUPPORTED	UMS wird nicht unterstützt.

Hinweise

Die QueryUmsThreadInformation-Funktion ruft Informationen über den angegebenen UMS-Workerthread ab, z. B. seinen anwendungsdefinierten Kontext, seinen Threadausführungsblock (TEB) und ob der Thread angehalten oder beendet wird.

Die zugrunde liegenden Strukturen für UMS-Arbeitsthreads werden vom System verwaltet. Informationen, die nicht über QueryUmsThreadInformation verfügbar gemacht werden, sollten als reserviert betrachtet 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 (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

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS

Freigeben über