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

Статья
08/08/2023

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

Синтаксис

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

Параметры

[in] PerformanceCounterValue

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

[out] AuxiliaryCounterValue

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

[out, optional] ConversionError

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 10.
Целевая платформа	Универсальное
Верхняя часть	wdm.h
Библиотека	Ntoskrnl.lib
DLL	Hal.dll
IRQL	Любой уровень

См. также раздел

KeConvertAuxiliaryCounterToPerformanceCounter

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