D3DDisassemble11Trace 関数 (d3d11shadertracing.h)
シェーダー トレースステップで指定されたコンパイル済みの Microsoft High Level Shader Language (HLSL) コードのセクションを逆アセンブルします。
構文
HRESULT D3DDisassemble11Trace(
[in] LPCVOID pSrcData,
[in] SIZE_T SrcDataSize,
[in] ID3D11ShaderTrace *pTrace,
[in] UINT StartStep,
[in] UINT NumSteps,
[in] UINT Flags,
[out] ID3D10Blob **ppDisassembly
);
パラメーター
[in] pSrcData
種類: LPCVOID
コンパイルされたシェーダー データへのポインター。
[in] SrcDataSize
種類: SIZE_T
pSrcData が指すメモリ ブロックのサイズ (バイト単位)。
[in] pTrace
種類: ID3D11ShaderTrace*
シェーダー トレース情報オブジェクトの ID3D11ShaderTrace インターフェイスへのポインター。
[in] StartStep
型: UINT
D3DDisassemble11Trace が逆アセンブリを開始するトレース内のステップの番号。
[in] NumSteps
型: UINT
逆アセンブルするトレース ステップの数。
[in] Flags
型: UINT
ビットごとの OR 演算を使用して結合される、次のフラグの 0 個以上の組み合わせ。 結果の値は、D3DDisassemble11Trace がコンパイルされたシェーダー データを逆アセンブルする方法を指定します。
| フラグ | 説明 |
|---|---|
| D3D_DISASM_ENABLE_COLOR_CODE (0x01) | カラー コードの出力を有効にします。 |
| D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02) | 既定値の出力を有効にします。 |
| D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04) | 命令番号付けを有効にします。 |
| D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08) | 影響しません。 |
| D3D_DISASM_DISABLE_DEBUG_INFO (0x10) | デバッグ情報の出力を無効にします。 |
| D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20) | 命令オフセットの出力を有効にします。 |
| D3D_DISASM_INSTRUCTION_ONLY (0x40) |
D3DDisassemble11Trace で、ステップごとの命令サイクルの出力を有効にします。 このフラグは、D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING フラグとD3D_DISASM_ENABLE_INSTRUCTION_OFFSET フラグに似ています。
このフラグは、D3DDisassembleRegion 関数には影響しません。 サイクル情報はトレースから取得されます。したがって、サイクル情報はトレース逆アセンブルでのみ使用できます。 |
[out] ppDisassembly
種類: ID3D10Blob**
逆アセンブルされた HLSL コードにアクセスする ID3DBlob インターフェイスを受け取るバッファーへのポインター。
戻り値
型: HRESULT
このメソッドは HRESULT エラー コードを返します。
注釈
D3DDisassemble11Trace は、シェーダー トレースの手順を説明し、ステップの命令インデックスに基づく各ステップの適切な逆アセンブリを出力します。 逆アセンブリには、トレースからのレジスタ値情報が注釈付けされます。 D3DDisassemble11Trace の動作は、D3DDisassemble が実行するコンパイル済みシェーダーの静的逆アセンブリではなく、D3DDisassemble11Trace がシェーダー トレース情報に基づく実行トレースを提供するという点で、D3DDisassemble11Trace とは異なります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d3d11shadertracing.h |
| [DLL] | D3D11SDKLayers.dll;D3D11_1SDKLayers.dll;D3D11_2SDKLayers.dll |