QueryUmsThreadInformation-Funktion (winbase.h)

  • Artikel

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