Функция QueryIdleProcessorCycleTimeEx (realtimeapiset.h)
Извлекает накопленный цикл времени для потока простоя на каждом логическом процессоре в указанной группе процессоров.
Синтаксис
BOOL QueryIdleProcessorCycleTimeEx(
[in] USHORT Group,
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Параметры
[in] Group
Номер группы процессоров, для которой требуется получить время цикла.
[in, out] BufferLength
При входе задает размер буфера ProcessorIdleCycleTime в байтах. Ожидается, что этот буфер в 8 раз больше числа процессоров в группе.
В выходных данных указывает количество элементов, записываемых в буфер. Если размер буфера недостателен, функция завершается ошибкой, и этот параметр получает необходимую длину буфера.
[out] ProcessorIdleCycleTime
Количество циклов ЦП, используемых каждым потоком бездействия. Если этот параметр имеет значение NULL, функция обновляет параметр BufferLength требуемой длиной.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте GetLastError.
Комментарии
Чтобы скомпилировать приложение, использующее эту функцию, задайте _WIN32_WINNT >= 0x0601. Дополнительные сведения см. в разделе Использование заголовков Windows.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | realtimeapiset.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |