Bagikan melalui

Fungsi D3DDisassemble11Trace (d3d11shadertracing.h)

  • Artikel

Membongkar bagian kode Microsoft High Level Shader Language (HLSL) yang dikompilasi yang ditentukan oleh langkah-langkah pelacakan shader.

Sintaks

HRESULT D3DDisassemble11Trace(
  [in]  LPCVOID           pSrcData,
  [in]  SIZE_T            SrcDataSize,
  [in]  ID3D11ShaderTrace *pTrace,
  [in]  UINT              StartStep,
  [in]  UINT              NumSteps,
  [in]  UINT              Flags,
  [out] ID3D10Blob        **ppDisassembly
);

Parameter

[in] pSrcData

Jenis: LPCVOID

Penunjuk ke data shader yang dikompilasi.

[in] SrcDataSize

Jenis: SIZE_T

Ukuran, dalam byte, dari blok memori yang dituju pSrcData.

[in] pTrace

Jenis: ID3D11ShaderTrace*

Penunjuk ke antarmuka ID3D11ShaderTrace untuk objek informasi pelacakan shader.

[in] StartStep

Jenis: UINT

Jumlah langkah dalam jejak dari mana D3DDisassemble11Trace memulai pembbongkaran.

[in] NumSteps

Jenis: UINT

Jumlah langkah pelacakan yang akan dibongkar.

[in] Flags

Jenis: UINT

Kombinasi nol atau lebih dari bendera berikut yang digabungkan dengan menggunakan operasi OR bitwise. Nilai yang dihasilkan menentukan bagaimana D3DDisassemble11Trace membongkar data shader yang dikompilasi.

Bendera Deskripsi
D3D_DISASM_ENABLE_COLOR_CODE (0x01) Aktifkan output kode warna.
D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02) Aktifkan output nilai default.
D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04) Aktifkan penomoran instruksi.
D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08) Tidak berpengaruh.
D3D_DISASM_DISABLE_DEBUG_INFO (0x10) Nonaktifkan output informasi debug.
D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20) Aktifkan output offset instruksi.
D3D_DISASM_INSTRUCTION_ONLY (0x40) Aktifkan output siklus instruksi per langkah di D3DDisassemble11Trace. Bendera ini mirip dengan bendera D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING dan D3D_DISASM_ENABLE_INSTRUCTION_OFFSET.

Bendera ini tidak berpengaruh dalam fungsi D3DDisassembleRegion. Informasi siklus berasal dari jejak; oleh karena itu, informasi siklus hanya tersedia dalam pembakaran jejak.

[out] ppDisassembly

Jenis: ID3D10Blob**

Penunjuk ke buffer yang menerima antarmuka ID3DBlob yang mengakses kode HLSL yang dibongkar.

Nilai kembali

Jenis: HRESULT

Metode ini mengembalikan kode kesalahan HRESULT.

Keterangan

D3DDisassemble11Trace berjalan dengan langkah-langkah jejak shader dan menghasilkan pembongkaran yang sesuai untuk setiap langkah yang didasarkan pada indeks instruksi langkah. Pembbongkaran diannotasikan dengan informasi register-value dari jejak. Perilaku D3DDisassemble11Trace berbeda dari D3DDisassemble dalam bahwa alih-alih pembongkaran statis dari shader yang dikompilasi yang dilakukan D3DDisassemble, D3DDisassemble11Trace menyediakan jejak eksekusi yang didasarkan pada informasi jejak shader.

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

Fungsi Shader