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

こちらもご覧ください

シェーダー関数