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

Статья
03/05/2024

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

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

Синтаксис

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

Параметры

[in, out] BufferLength

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

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

[out] ProcessorIdleCycleTime

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	realtimeapiset.h (включая Windows.h в Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

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

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime