GetProcessorSystemCycleTime-Funktion (sysinfoapi.h)

  • Artikel

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

Siehe auch

Prozessorgruppen