Compartir a través de

Función VideoPortQueryPerformanceCounter (video.h)

  • Artículo

La función VideoPortQueryPerformanceCounter proporciona el recuento de ejecución más específico disponible en el sistema.

Sintaxis

VIDEOPORT_API LONGLONG VideoPortQueryPerformanceCounter(
  IN PVOID      HwDeviceExtension,
  OUT PLONGLONG PerformanceFrequency
);

Parámetros

HwDeviceExtension

[in] Puntero a la extensión del dispositivo del controlador de minipuerto.

PerformanceFrequency

[out, opcional] Puntero opcional a una variable que va a recibir la frecuencia del contador de rendimiento.

Valor devuelto

VideoPortQueryPerformanceCounter devuelve el valor del contador de rendimiento en unidades de tics.

Comentarios

VideoPortQueryPerformanceCounter siempre devuelve un entero de 64 bits que representa el número de tics. La acumulación del recuento comienza cuando se arranca el sistema. El recuento está en tics; PerformanceFrequency notifica la frecuencia si se proporciona este parámetro opcional.

La resolución del temporizador utilizado para acumular el recuento actual se puede obtener especificando PerformanceFrequency. Por ejemplo, si performanceFrequency devuelto es de 2 millones, cada tic es 1/2ésima de segundo. Cada incremento de 1/x millón del recuento corresponde a un segundo de tiempo transcurrido.

VideoPortQueryPerformanceCounter está pensado para paquetes de marca de tiempo o para calcular medidas de rendimiento y capacidad. No está pensado para medir el tiempo transcurrido, para los puestos informáticos o esperas, ni para iteraciones.

Use esta rutina lo más poco frecuente posible. Según la plataforma, VideoPortQueryPerformanceCounter puede deshabilitar las interrupciones en todo el sistema durante un intervalo mínimo. Por lo tanto, llamar a esta rutina con frecuencia o repetidamente, como en una iteración, derrota su propósito de devolver información de marca de tiempo muy específica y en ejecución. Llamar a esta rutina con demasiada frecuencia puede degradar el rendimiento de E/S para el controlador de llamada y para el sistema en su conjunto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP
Plataforma de destino Escritorio
Encabezado video.h (incluir Video.h)
Library Videoprt.lib
Archivo DLL Videoprt.sys
IRQL Cualquier nivel