Función KeConvertPerformanceCounterToAuxiliaryCounter (wdm.h)

  • Artículo

La rutina KeConvertPerformanceCounterToAuxiliaryCounter convierte el valor del contador de rendimiento especificado en un valor de contador auxiliar.

Sintaxis

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

Parámetros

[in] PerformanceCounterValue

Valor del contador de rendimiento que se va a convertir.

[out] AuxiliaryCounterValue

Puntero a la variable que contiene el valor del contador auxiliar convertido.

[out, optional] ConversionError

Puntero a una variable que contiene el error de conversión estimado en unidades de nanosegundos.

Valor devuelto

KeConvertPerformanceCounterToAuxiliaryCounter puede devolver una de las siguientes opciones:

Código devuelto Descripción
STATUS_SUCCESS
 La conversión se realizó correctamente.
STATUS_NOT_SUPPORTED
 No se admite el contador auxiliar.
STATUS_INVALID_PARAMETER
El valor PerformanceCounterValue no es válido. Por ejemplo, el valor es anterior al último arranque o recuperación del sistema, o está fuera del intervalo +/- 10s en comparación con el valor del contador de rendimiento actual.
STATUS_UNSUCCESSFUL
La rutina no puede convertir el valor especificado con precisión aceptable.

Comentarios

Asegúrese de que el valor del contador de rendimiento especificado sea:

  • Dentro de +/- 10s en comparación con el valor de lectura del contador de rendimiento actual.
  • No anterior al valor del contador de rendimiento registrado en el último arranque del sistema o recuperación del estado S3/S4.
El valor ConversionError es la diferencia, en nanosegundos, entre el valor calculado esperado y el valor calculado real para el contador auxiliar. Si el valor ConversionError es mayor que el valor esperado (determinado por usted), vuelva a llamar a la rutina.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 10.
Plataforma de destino Universal
Encabezado wdm.h
Library Ntoskrnl.lib
Archivo DLL Hal.dll
IRQL Cualquier nivel

Consulte también

KeConvertAuxiliaryCounterToPerformanceCounter