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

Статья
11/08/2024

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

Синтаксис

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 [только классические приложения]
целевая платформа	Виндоус
заголовка	realtimeapiset.h (включая Windows.h)
библиотеки	Mincore.lib
DLL	Kernel32.dll

См. также

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

QueryIdleProcessorCycleTime

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