Функция QueryIdleProcessorCycleTime (realtimeapiset.h)

Извлекает время цикла для потока простоя каждого процессора в системе.

В системе с более чем 64 процессорами эта функция извлекает время цикла для потока простоя каждого процессора в группе процессоров , которой назначается вызывающий поток. Используйте функцию QueryIdleProcessorCycleTimeEx, чтобы получить время цикла для потока простоя для каждого логического процессора для определенной группы процессоров.

Синтаксис

BOOL QueryIdleProcessorCycleTime(
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

Параметры

[in, out] BufferLength

В входных данных указывает размер буфера ProcessorIdleCycleTime в байтах. Ожидается, что этот буфер составляет 8 раз, чем количество процессоров в группе.

В выходных данных указывает количество элементов, записанных в буфер. Если размер буфера недостаточно, функция завершается ошибкой, и этот параметр получает необходимую длину буфера.

[out] ProcessorIdleCycleTime

Количество циклов часов ЦП, используемых каждым потоком простоя. Этот буфер должен составлять 8 раз, чем количество процессоров в системе в размере.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии.

Требования

См. также

группы обработчиков

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime