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

Lihat juga

Grup Prosesor

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime