Fungsi QueryIdleProcessorCycleTime (realtimeapiset.h)
Mengambil waktu siklus untuk utas diam setiap prosesor dalam sistem.
Pada sistem dengan lebih dari 64 prosesor, fungsi ini mengambil waktu siklus untuk utas menganggur setiap prosesor dalam grup prosesor tempat utas panggilan ditetapkan. Gunakan fungsi QueryIdleProcessorCycleTimeEx untuk mengambil waktu siklus untuk utas diam pada setiap prosesor logis untuk grup prosesor tertentu.
Sintaks
BOOL QueryIdleProcessorCycleTime(
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Parameter
[in, out] BufferLength
Pada input, menentukan ukuran buffer ProcessorIdleCycleTime , dalam byte. Buffer ini diperkirakan 8 kali jumlah prosesor dalam grup.
Pada output, menentukan jumlah elemen yang ditulis ke buffer. Jika ukuran buffer tidak cukup, fungsi gagal dan parameter ini menerima panjang buffer yang diperlukan.
[out] ProcessorIdleCycleTime
Jumlah siklus jam CPU yang digunakan oleh setiap utas diam. Buffer ini harus 8 kali jumlah prosesor dalam ukuran sistem.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | realtimeapiset.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |