QueryIdleProcessorCycleTime-Funktion (realtimeapiset.h)
Ruft die Zykluszeit für den Leerlaufthread jedes Prozessors im System ab.
Auf einem System mit mehr als 64 Prozessoren ruft diese Funktion die Zykluszeit für den Leerlaufthread jedes Prozessors in der Prozessorgruppe ab, der der aufrufende Thread zugewiesen ist. Verwenden Sie die QueryIdleProcessorCycleTimeEx-Funktion , um die Zykluszeit für den Leerlaufthread auf jedem logischen Prozessor für eine bestimmte Prozessorgruppe abzurufen.
Syntax
BOOL QueryIdleProcessorCycleTime(
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Parameter
[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. Dieser Puffer muss die 8-fache Anzahl von Prozessoren im System aufweisen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | realtimeapiset.h (einschließlich Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für