Поделиться через


Функция 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

См. также

Группы процессоров

QueryIdleProcessorCycleTime