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

Требования

См. также

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

QueryIdleProcessorCycleTime