QueryIdleProcessorCycleTimeEx-Funktion (realtimeapiset.h)

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 Eingaben die Größe des ProcessorIdleCycleTime- Puffers in Byte an. Dieser Puffer wird voraussichtlich 8 Mal die Anzahl der Prozessoren in der Gruppe sein.

Gibt bei der Ausgabe die Anzahl der elemente an, die in den Puffer geschrieben wurden. Wenn die Puffergröße nicht ausreicht, schlägt die Funktion fehl, 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 fehlschlägt, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, verwenden Sie GetLastError-.

Bemerkungen

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

Siehe auch

Prozessorgruppen

QueryIdleProcessorCycleTime-