QueryIdleProcessorCycleTimeEx-Funktion (realtimeapiset.h)

  • Artikel

Ruft die akkumulierte Zykluszeit für den Leerlaufthread auf jedem logischen Prozessor in der angegebenen Prozessorgruppe ab.

Syntax

BOOL QueryIdleProcessorCycleTimeEx(
  [in]      USHORT   Group,
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

Parameter

[in] Group

Die Anzahl der Prozessorgruppe, für die die Zykluszeit abgerufen werden soll.

[in, out] BufferLength

Gibt bei der Eingabe die Größe des ProcessorIdleCycleTime-Puffers in Bytes an. Es wird erwartet, dass dieser Puffer das 8-fache der Anzahl von Prozessoren in der Gruppe beträgt.

Gibt bei der Ausgabe die Anzahl der In den Puffer geschriebenen Elemente an. Wenn die Puffergröße nicht ausreicht, tritt bei der Funktion ein Fehler auf, und dieser Parameter empfängt die erforderliche Länge des Puffers.

[out] ProcessorIdleCycleTime

Die Anzahl der CPU-Taktzyklen, die von jedem Leerlaufthread verwendet werden. Wenn dieser Parameter NULL ist, aktualisiert die Funktion den BufferLength-Parameter mit der erforderlichen Länge.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie GetLastError, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, legen Sie _WIN32_WINNT >= 0x0601 fest. 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 realtimeapiset.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Prozessorgruppen

QueryIdleProcessorCycleTime