D3DPERF_BeginEvent (Fungsi D3DPERF_BeginEvent)

  • Artikel

Menandai awal peristiwa yang ditentukan pengguna. PIX dapat menggunakan kejadian ini untuk memicu tindakan.

Sintaks

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

Parameter

col

Warna peristiwa. Ini adalah warna untuk menampilkan peristiwa dalam tampilan peristiwa.

wszName

Nama peristiwa.

Nilai kembali

Tingkat hierarki berbasis nol tempat kejadian ini dimulai. Jika terjadi kesalahan, nilai yang dikembalikan akan negatif.

Keterangan

Peristiwa yang ditentukan pengguna mengelompokkan peristiwa lain dengan cara yang bermakna bagi program target sehingga mereka dapat lebih terwakili dalam alat pembuatan profil performa. Misalnya, peristiwa Draw Spaceship mungkin membungkus sejumlah panggilan Direct3D yang menangani menggambar pesawat ruang angkasa dalam permainan. Peristiwa dapat ditumpuk.

Setiap panggilan D3DPERF_BeginEvent harus memiliki panggilan D3DPERF_EndEvent yang cocok. Peristiwa seketika (yang tidak mengabaikan peristiwa lain) harus diberi label dengan menggunakan D3DPERF_SetMarker daripada dengan D3DPERF_BeginEvent dan D3DPERF_EndEvent.

Persyaratan

   
Target Platform Windows
Header d3d9.h
Pustaka d3d9.lib
DLL d3d9.dll