QueryThreadCycleTime-Funktion (realtimeapiset.h)

Ruft die Zykluszeit für den angegebenen Thread ab.

Syntax

BOOL QueryThreadCycleTime(
  [in]  HANDLE   ThreadHandle,
  [out] PULONG64 CycleTime
);

Parameter

[in] ThreadHandle

Ein Handle für den Thread. Das Handle muss über das PROCESS_QUERY_INFORMATION oder PROCESS_QUERY_LIMITED_INFORMATION Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheits- und Zugriffsberechtigungen.

[out] CycleTime

Die Anzahl der vom Thread verwendeten CPU-Taktzyklen. Dieser Wert enthält Zyklen, die sowohl im Benutzermodus als auch im Kernelmodus ausgegeben werden.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Verwenden Sie zum Aufzählen der Threads des Prozesses die funktionen Thread32First- und Thread32Next-. Um das Threadhandle für einen Threadbezeichner abzurufen, verwenden Sie die OpenThread--Funktion.

Versuchen Sie nicht, die cpu-Taktzyklen zu konvertieren, die von QueryThreadCycleTime- in verstrichene Zeit zurückgegeben werden. Diese Funktion verwendet Zeitgeberdienste, die von der CPU bereitgestellt werden, was in der Implementierung variieren kann. Beispielsweise variieren einige CPUs die Häufigkeit des Timers, wenn die Häufigkeit geändert wird, mit der die CPU ausgeführt wird, und andere lassen sie mit einer festen Rate. Das Verhalten jeder CPU wird in der vom CPU-Anbieter bereitgestellten Dokumentation beschrieben.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.

Anforderungen

Siehe auch

QueryIdleProcessorCycleTime-

QueryProcessCycleTime-