QueryProcessCycleTime-Funktion (realtimeapiset.h)
Ruft die Summe der Zykluszeit aller Threads des angegebenen Prozesses ab.
Syntax
BOOL QueryProcessCycleTime(
[in] HANDLE ProcessHandle,
[out] PULONG64 CycleTime
);
Parameter
[in] ProcessHandle
Ein Handle für den Prozess. 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 CPU-Taktzyklen, die von den Threads des Prozesses verwendet werden. 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
Verwenden Sie die EnumProcesses-Funktion , um die Prozesse im System aufzulisten.
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 |