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, dem der aufrufende Thread zugewiesen ist. Verwenden Sie die QueryIdleProcessorCycleTimeEx--Funktion, um die Zykluszeit für den Leerlaufthread für jeden logischen Prozessor für eine bestimmte Prozessorgruppe abzurufen.
Syntax
BOOL QueryIdleProcessorCycleTime(
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Parameter
[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. Dieser Puffer muss 8 Mal die Anzahl der Prozessoren im System in der Größe aufweisen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | realtimeapiset.h (enthalten Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Library | Mincore.lib |
| DLL- | Kernel32.dll |