Fungsi VideoPortQueryPerformanceCounter (video.h)

Artikel
02/29/2024

Fungsi VideoPortQueryPerformanceCounter menyediakan jumlah berjalan terperinci yang tersedia dalam sistem.

Sintaks

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

Parameter

HwDeviceExtension

[in] Arahkan ke ekstensi perangkat driver miniport.

PerformanceFrequency

[out, opsional] Penunjuk opsional ke variabel yaitu menerima frekuensi penghitung kinerja.

Nilai kembali

VideoPortQueryPerformanceCounter mengembalikan nilai penghitung kinerja dalam satuan tick.

Keterangan

VideoPortQueryPerformanceCounter selalu mengembalikan bilangan bulat 64-bit yang menunjukkan jumlah tick. Mengakumulasi hitungan dimulai ketika sistem di-boot. Hitungannya dalam tanda centang; frekuensi dilaporkan oleh PerformanceFrequency jika parameter opsional ini disediakan.

Resolusi timer yang digunakan untuk mengakumulasi jumlah saat ini dapat diperoleh dengan menentukan PerformanceFrequency. Misalnya, jika PerformanceFrequency yang dikembalikan adalah 2 juta, setiap tick adalah 1/2 juta detik. Setiap kenaikan 1/x juta dari hitungan sesuai dengan satu detik waktu yang berlalu.

VideoPortQueryPerformanceCounter ditujukan untuk paket stempel waktu atau untuk pengukuran performa dan kapasitas komputasi. Ini tidak dimaksudkan untuk mengukur waktu yang berlalu, untuk menghitung kios atau menunggu, atau untuk iterasi.

Gunakan rutinitas ini jarang. Bergantung pada platform, VideoPortQueryPerformanceCounter dapat menonaktifkan interupsi di seluruh sistem untuk interval minimal. Akibatnya, memanggil rutinitas ini secara sering atau berulang kali, seperti dalam iterasi, mengalahkan tujuannya untuk mengembalikan informasi stempel waktu yang sangat halus dan berjalan. Memanggil rutinitas ini terlalu sering dapat menurunkan performa I/O untuk driver panggilan dan untuk sistem secara keseluruhan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	Tingkat apa pun

Bagikan melalui