Antarmuka ID3DUserDefinedAnnotation (d3d11_1.h)

Antarmuka ID3DUserDefinedAnnotation memungkinkan aplikasi untuk menjelaskan bagian konseptual dan penanda dalam alur kode aplikasi. Alat yang diaktifkan dengan tepat, seperti Microsoft Visual Studio Ultimate 2012, dapat menampilkan bagian dan penanda ini secara visual di sepanjang garis waktu Microsoft Direct3D alat, sementara alat men-debug aplikasi. Catatan visual ini memungkinkan pengguna alat tersebut untuk menavigasi ke bagian garis waktu yang menarik, atau untuk memahami kumpulan panggilan Direct3D apa yang diproduksi oleh bagian tertentu dari kode aplikasi.

Warisan

Antarmuka ID3DUserDefinedAnnotation mewarisi dari antarmuka IUnknown . ID3DUserDefinedAnnotation juga memiliki jenis anggota berikut:

Metode

Antarmuka ID3DUserDefinedAnnotation memiliki metode ini.

ID3DUserDefinedAnnotation::BeginEvent Menandai awal bagian kode peristiwa.
ID3DUserDefinedAnnotation::EndEvent Menandai akhir bagian kode peristiwa.
ID3DUserDefinedAnnotation::GetStatus Menentukan apakah aplikasi panggilan berjalan di bawah alat pembuatan profil Microsoft Direct3D.
ID3DUserDefinedAnnotation::SetMarker Menandai satu titik eksekusi dalam kode.

Keterangan

Metode ID3DUserDefinedAnnotation tidak berpengaruh ketika aplikasi panggilan tidak berjalan di bawah alat pembuatan profil khusus Direct3D seperti Visual Studio Ultimate 2012.

Antarmuka ID3DUserDefinedAnnotation diterbitkan oleh konteks perangkat Microsoft Direct3D 11. Oleh karena itu, ID3DUserDefinedAnnotation memiliki aturan utas yang sama dengan antarmuka ID3D11DeviceContext , atau antarmuka konteks lainnya. Untuk informasi selengkapnya tentang utas Direct3D, lihat MultiThreading. Untuk mengambil antarmuka ID3DUserDefinedAnnotation untuk konteks, panggil metode QueryInterface untuk konteks (misalnya, ID3D11DeviceContext::QueryInterface). Dalam panggilan ini, Anda harus meneruskan pengidentifikasi ID3DUserDefinedAnnotation.

Antarmuka ID3DUserDefinedAnnotation adalah Microsoft Direct3D 10 dan yang lebih baru setara dengan fungsi DIRECT3D 9 PIX (D3DPERF_* fungsi).

Catatan Mengatur bendera D3D11_CREATE_DEVICE_PREVENT_ALTERING_LAYER_SETTINGS_FROM_REGISTRY di aplikasi Anda menggantikan panggilan D3DPerf_SetOptions(1). Tetapi, untuk mencegah alat penelusuran kesalahan Direct3D menghubungkan aplikasi Anda, aplikasi Anda juga dapat memanggil ID3DUserDefinedAnnotation::GetStatus untuk menentukan apakah aplikasi berjalan di bawah alat penelusuran kesalahan Direct3D lalu keluar dengan sesuai.

 

Anda harus memanggil metode BeginEvent dan EndEvent berpasangan; pasangan panggilan ke metode ini dapat bersarang dalam pasangan panggilan ke metode ini pada tingkat yang lebih tinggi dalam tumpukan panggilan aplikasi. Dengan kata lain, bagian "Gambar Dunia" sepenuhnya dapat berisi bagian lain bernama "Gambar Pohon," yang pada gilirannya dapat sepenuhnya berisi bagian yang disebut "Gambar Ek." Anda hanya dapat mengaitkan metode EndEvent dengan metode BeginEvent terbaru, yaitu pasangan tidak dapat tumpang tindih. Anda tidak dapat memanggil EndEvent untuk BeginEvent apa pun yang mendahului BeginEvent terbaru. Bahkan, runtime menginterpretasikan EndEvent pertama sebagai mengakhiri BeginEvent kedua.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Platform Update untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	d3d11_1.h

Lihat juga

Antarmuka Versi Umum

IUnknown