GetProcessorSystemCycleTime-Funktion (sysinfoapi.h)
Ruft die Zykluszeit ab, die jeder Prozessor in der angegebenen Prozessorgruppe für die Ausführung verzögerter Prozeduraufrufe (DpCs) und Interruptdienstroutinen (ISRs) aufgewendet hat, seit der Prozessor aktiv wurde.
Syntax
BOOL GetProcessorSystemCycleTime(
[in] USHORT Group,
[out] PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
[in, out] PDWORD ReturnedLength
);
Parameter
[in] Group
Die Anzahl der Prozessorgruppe, für die die Zykluszeit abgerufen werden soll.
[out] Buffer
Ein Zeiger auf einen Puffer zum Empfangen einer SYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION-Struktur für jeden Prozessor in der Gruppe. Bei der Ausgabe wird der DWORD64 CycleTime-Member dieser Struktur auf die Zykluszeit für einen Prozessor festgelegt.
[in, out] ReturnedLength
Die Größe des Puffers in Bytes. Wenn die Funktion zurückgibt, enthält dieser Parameter die Anzahl von Bytes, die in Buffer geschrieben wurden. Wenn der Puffer für die Daten zu klein ist, schlägt die Funktion mit ERROR_INSUFFICIENT_BUFFER fehl und legt den Parameter ReturnedLength auf die erforderliche Puffergröße fest.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie GetLastError, um erweiterte Fehlerinformationen abzurufen.
Wenn der Fehlerwert ERROR_INSUFFICIENT_BUFFER ist, enthält der ReturnedLength-Parameter die erforderliche Puffergröße.
Hinweise
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0601 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | sysinfoapi.h (windows.h einschließen) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |