Fungsi D3DDisassemble11Trace (d3d11shadertracing.h)
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 |