Share via

ID3D11ShaderTrace::Metode TraceReady (d3d11shadertracing.h)

  • Artikel

Menentukan bahwa jejak shader direkam dan siap digunakan.

Sintaks

HRESULT TraceReady(
  [out, optional] UINT64 *pTestCount
);

Parameter

[out, optional] pTestCount

Penunjuk opsional ke variabel yang menerima berapa kali pemanggilan yang cocok untuk pelacakan terjadi. Jika tidak digunakan, atur ke NULL. Untuk informasi selengkapnya tentang nomor ini, lihat Keterangan.

Nilai kembali

TraceReady mengembalikan:

  • S_OK jika jejak sudah siap.
  • S_FALSE jika jejak belum siap.
  • E_OUTOFMEMORY jika memori habis saat jejak sedang dalam proses perekaman. Anda dapat mencoba merekam jejak lagi dengan memanggil ID3D11ShaderTrace::ResetTrace lalu menguraikan ulang. Jika Anda memutuskan untuk tidak merekam jejak lagi, rilis antarmuka ID3D11ShaderTrace .
  • Mungkin kode kesalahan lain yang dijelaskan dalam Direct3D 11 Return Codes.

Keterangan

Jika pelacakan dimaksudkan untuk merekam pemanggilan 3 tetapi hanya dua pemanggilan yang terjadi sejauh ini, TraceReady mengatur variabel tempat pTestCount menunjuk ke 2. Anda dapat menggunakan nilai ini untuk memahami mengapa jejak belum siap. Sebaliknya, variabel tempat titik pTestCount mungkin lebih besar dari jumlah pemanggilan yang diminta untuk jejak yang siap. Anda dapat menggunakan nilai ini untuk menentukan jumlah pemanggilan yang berjalan melewati jumlah pemanggilan jejak yang diperlukan. Misalnya, Anda mungkin tidak mengetahui jumlah overdraw yang terjadi pada piksel untuk shader tertentu dalam panggilan gambar. Jika Anda dapat menggambar ulang adegan secara identik, Anda dapat menyiapkan jejak ini lain kali berdasarkan nilai yang dikembalikan TraceReady di pTestCount pada pass pertama.

Jika jejak shader direkam, Anda dapat berhasil memanggil metode ID3D11ShaderTrace::GetTraceStats, ID3D11ShaderTrace::GetInitialRegisterContents, dan ID3D11ShaderTrace::GetStep . Anda dapat memanggil metode ID3D11ShaderTrace::ResetTrace dan ID3D11ShaderTrace::P SSelectStamp terlepas dari apakah jejak shader direkam.

Catatan API ini memerlukan Windows Software Development Kit (SDK) untuk Windows 8.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header d3d11shadertracing.h
DLL D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

Lihat juga

ID3D11ShaderTrace