GetThreadTimes-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Ruft Zeitsteuerungsinformationen für den angegebenen Thread ab.

Syntax

BOOL GetThreadTimes(
  [in]  HANDLE     hThread,
  [out] LPFILETIME lpCreationTime,
  [out] LPFILETIME lpExitTime,
  [out] LPFILETIME lpKernelTime,
  [out] LPFILETIME lpUserTime
);

Parameter

[in] hThread

Ein Handle für den Thread, dessen Zeitsteuerungsinformationen gesucht werden. Das Handle muss über das zugriffsrecht THREAD_QUERY_INFORMATION oder THREAD_QUERY_LIMITED_INFORMATION verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das zugriffsrecht THREAD_QUERY_INFORMATION verfügen.

[out] lpCreationTime

Ein Zeiger auf eine FILETIME-Struktur , die die Erstellungszeit des Threads empfängt.

[out] lpExitTime

Ein Zeiger auf eine FILETIME-Struktur , die die Beendigungszeit des Threads empfängt. Wenn der Thread nicht beendet wurde, ist der Inhalt dieser Struktur nicht definiert.

[out] lpKernelTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeit empfängt, die der Thread im Kernelmodus ausgeführt hat.

[out] lpUserTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeit empfängt, die der Thread im Benutzermodus ausgeführt hat.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Alle Zeiten werden mithilfe von FILETIME-Datenstrukturen ausgedrückt. Eine solche Struktur enthält zwei 32-Bit-Werte, die kombiniert werden, um eine 64-Bit-Anzahl von 100-Nanosekunden-Zeiteinheiten zu bilden.

Threaderstellungs- und -exitzeiten sind Zeitpunkte, ausgedrückt als die Zeitspanne, die seit Mitternacht am 1. Januar 1601 in Greenwich, England verstrichen ist. Es gibt mehrere Funktionen, die eine Anwendung verwenden kann, um solche Werte in allgemein nützlichere Formulare zu konvertieren. siehe Zeitfunktionen.

Threadkernmodus- und Benutzermoduszeiten sind Zeitbeträge. Wenn ein Thread beispielsweise eine Sekunde im Kernelmodus verbracht hat, füllt diese Funktion die von lpKernelTime angegebene FILETIME-Struktur mit einem 64-Bit-Wert von zehn Millionen aus. Das ist die Anzahl von 100 Nanosekundeneinheiten in einer Sekunde.

Verwenden Sie die Funktion QueryThreadCycleTime , um die Anzahl der CPU-Taktzyklen abzurufen, die von den Threads verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll