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

Функция GetProcessorSystemCycleTime (sysinfoapi.h)

  • Статья

Извлекает время цикла каждого процессора в указанной группе процессоров, затраченное на выполнение отложенных вызовов процедур (DPCs) и подпрограмм обслуживания прерывания (ISR) с момента его активности.

Синтаксис

BOOL GetProcessorSystemCycleTime(
  [in]      USHORT                                   Group,
  [out]     PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
  [in, out] PDWORD                                   ReturnedLength
);

Параметры

[in] Group

Номер группы процессоров, для которой требуется получить время цикла.

[out] Buffer

Указатель на буфер для получения SYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION структуры для каждого процессора в группе. В выходных данных элементу DWORD64 CycleTime этой структуры присваивается время цикла для одного процессора.

[in, out] ReturnedLength

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

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

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

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

Если значение ошибки ERROR_INSUFFICIENT_BUFFER, параметр ReturnedLength содержит требуемый размер буфера.

Комментарии

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

Требования

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

См. также

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