Funzione VideoPortQueryPerformanceCounter (video.h)

La funzione VideoPortQueryPerformanceCounter offre il numero di esecuzione più dettagliato disponibile nel sistema.

Sintassi

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

Parametri

HwDeviceExtension

[in] Puntatore all'estensione del dispositivo del driver miniport.

PerformanceFrequency

[out, facoltativo] Puntatore facoltativo a una variabile che deve ricevere la frequenza del contatore delle prestazioni.

Valore restituito

VideoPortQueryPerformanceCounter restituisce il valore del contatore delle prestazioni in unità di tick.

Commenti

VideoPortQueryPerformanceCounter restituisce sempre un intero a 64 bit che rappresenta il numero di tick. L'accumulazione del conteggio inizia quando il sistema viene avviato. Il conteggio è in zecche; la frequenza viene segnalata da PerformanceFrequency se questo parametro facoltativo viene fornito.

La risoluzione del timer usato per accumulare il conteggio corrente può essere ottenuta specificando PerformanceFrequency. Ad esempio, se l'oggetto PerformanceFrequency restituito è pari a 2 milioni, ogni segno di spunta è pari a 1/2 milioni di secondi. Ogni incremento di 1/x milione del conteggio corrisponde a un secondo di tempo trascorso.

VideoPortQueryPerformanceCounter è destinato a pacchetti di timestamp o per le misurazioni delle prestazioni e della capacità di calcolo. Non è previsto per misurare il tempo trascorso, per le stalle di calcolo o per le attese o per le iterazioni.

Usare questa routine come raramente possibile. A seconda della piattaforma, VideoPortQueryPerformanceCounter può disabilitare gli interruzioni a livello di sistema per un intervallo minimo. Di conseguenza, chiamando questa routine spesso o ripetutamente, come in un'iterazione, sconfigge il suo scopo di restituire informazioni con granularità molto fine, con timestamp in esecuzione. La chiamata a questa routine troppo spesso può ridurre le prestazioni di I/O per il driver chiamante e per tutto il sistema.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Piattaforma di destinazione	Desktop
Intestazione	video.h (includere Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	Qualsiasi livello