Fungsi GetProcessTimes (processthreadsapi.h)

Artikel
03/04/2024

Mengambil informasi waktu untuk proses yang ditentukan.

Sintaks

BOOL GetProcessTimes(
  [in]  HANDLE     hProcess,
  [out] LPFILETIME lpCreationTime,
  [out] LPFILETIME lpExitTime,
  [out] LPFILETIME lpKernelTime,
  [out] LPFILETIME lpUserTime
);

Parameter

[in] hProcess

Handel untuk proses yang informasi waktunya dicari. Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION atau PROCESS_QUERY_LIMITED_INFORMATION . Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.

Windows Server 2003 dan Windows XP: Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION .

[out] lpCreationTime

Penunjuk ke struktur FILETIME yang menerima waktu pembuatan proses.

[out] lpExitTime

Penunjuk ke struktur FILETIME yang menerima waktu keluar proses. Jika proses belum keluar, konten struktur ini tidak terdefinisi.

[out] lpKernelTime

Penunjuk ke struktur FILETIME yang menerima jumlah waktu proses telah dijalankan dalam mode kernel. Waktu setiap utas proses telah dijalankan dalam mode kernel ditentukan, dan kemudian semua waktu tersebut dijumlahkan bersama-sama untuk mendapatkan nilai ini.

[out] lpUserTime

Penunjuk ke struktur FILETIME yang menerima jumlah waktu proses telah dijalankan dalam mode pengguna. Waktu setiap utas proses telah dijalankan dalam mode pengguna ditentukan, dan kemudian semua waktu tersebut dijumlahkan bersama-sama untuk mendapatkan nilai ini. Perhatikan bahwa nilai ini dapat melebihi jumlah real time yang berlalu (antara lpCreationTime dan lpExitTime) jika proses dijalankan di beberapa inti CPU.

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

Semua waktu diekspresikan menggunakan struktur data FILETIME . Struktur tersebut berisi dua nilai 32-bit yang digabungkan untuk membentuk jumlah 64-bit dari unit waktu 100 nanodetik.

Pembuatan proses dan waktu keluar adalah titik waktu yang dinyatakan sebagai jumlah waktu yang telah berlalu sejak tengah malam pada 1 Januari 1601 di Greenwich, Inggris. Ada beberapa fungsi yang dapat digunakan aplikasi untuk mengonversi nilai tersebut ke bentuk yang lebih berguna secara umum.

Mode kernel proses dan waktu mode pengguna adalah jumlah waktu. Misalnya, jika proses telah menghabiskan satu detik dalam mode kernel, fungsi ini akan mengisi struktur FILETIME yang ditentukan oleh lpKernelTime dengan nilai 64-bit sepuluh juta. Itu adalah jumlah unit 100 nanodetik dalam satu detik.

Untuk mengambil jumlah siklus jam CPU yang digunakan oleh utas proses, gunakan fungsi QueryProcessCycleTime .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll