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