Функция KeConvertPerformanceCounterToAuxiliaryCounter (wdm.h)

Статья
02/07/2025

Подпрограмма KeConvertPerformanceCounterToAuxiliaryCounter преобразует указанное значение счетчика производительности в вспомогательное значение счетчика.

Синтаксис

NTSTATUS KeConvertPerformanceCounterToAuxiliaryCounter(
  [in]            ULONG64  PerformanceCounterValue,
  [out]           PULONG64 AuxiliaryCounterValue,
  [out, optional] PULONG64 ConversionError
);

Параметры

[in] PerformanceCounterValue

Значение счетчика производительности для преобразования.

[out] AuxiliaryCounterValue

Указатель на переменную, содержащую преобразованное вспомогательное значение счетчика.

[out, optional] ConversionError

Указатель на переменную, содержащую предполагаемую ошибку преобразования в единицах nanosecond.

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

KeConvertPerformanceCounterToAuxiliaryCounter может вернуть одно из следующих элементов:

Возвращаемый код	Описание
STATUS_SUCCESS	Преобразование выполнено успешно.
STATUS_NOT_SUPPORTED	Вспомогательный счетчик не поддерживается.
STATUS_INVALID_PARAMETER	Недопустимое значение PerformanceCounterValue. Например, значение выше последней загрузки и восстановления системы или выходит из диапазона +/-10s по сравнению с текущим значением счетчика производительности.
STATUS_UNSUCCESSFUL	Подпрограмма не может преобразовать указанное значение с допустимой точностью.

Замечания

Убедитесь, что указанное значение счетчика производительности:

В пределах +/-10 по сравнению с текущим значением счетчика производительности.
Не раньше записанного значения счетчика производительности при последней загрузке системы или восстановлении из состояния S3/S4.

Значение преобразования ПреобразованияError — это разница между ожидаемым вычисляемым значением и фактическим вычисляемым значением вспомогательного счетчика. Если значение ConversionError больше ожидаемого значения (определяется вами), вызовите подпрограмму еще раз.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 10.
целевая платформа	Всеобщий
заголовка	wdm.h
библиотеки	Ntoskrnl.lib
DLL	Hal.dll
IRQL	Любой уровень

См. также

KeConvertAuxiliaryCounterToPerformanceCounter

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