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 auf den Thread. Das Handle muss über das PROCESS_QUERY_INFORMATION- oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.
[out] CycleTime
Die Anzahl der vom Thread verwendeten CPU-Taktzyklen. Dieser Wert umfasst Zyklen, die sowohl im Benutzermodus als auch im Kernelmodus verbracht werden.
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
Um die Threads des Prozesses aufzulisten, verwenden Sie die Funktionen Thread32First und Thread32Next . Verwenden Sie die OpenThread-Funktion , um das Threadhandle für einen Threadbezeichner abzurufen.
Versuchen Sie nicht, die von QueryThreadCycleTime zurückgegebenen CPU-Taktzyklen in verstrichene Zeit zu konvertieren. Diese Funktion verwendet von der CPU bereitgestellte Zeitgeberdienste, die in der Implementierung variieren können. Beispielsweise variieren einige CPUs die Häufigkeit des Timers, wenn sie die Häufigkeit ändern, mit der die CPU ausgeführt wird, und andere weisen eine feste Rate auf. 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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | realtimeapiset.h (einschließen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für