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 Prozesssicherheits- und Zugriffsberechtigungen.

[out] CycleTime

Die Anzahl der CPU-Taktzyklen, die von den Threads des Prozesses verwendet werden. 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 Prozesse im System die EnumProcesses-Funktion.

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

Anforderungen

Siehe auch

QueryIdleProcessorCycleTime-

QueryThreadCycleTime-