D3D11_TRACE_STATS構造体 (d3d11shadertracing.h)

[アーティクル]
08/23/2023

トレースに関する統計を指定します。

構文

typedef struct D3D11_TRACE_STATS {
  D3D11_SHADER_TRACE_DESC        TraceDesc;
  UINT8                          NumInvocationsInStamp;
  UINT8                          TargetStampIndex;
  UINT                           NumTraceSteps;
  D3D11_TRACE_COMPONENT_MASK     InputMask[32];
  D3D11_TRACE_COMPONENT_MASK     OutputMask[32];
  UINT16                         NumTemps;
  UINT16                         MaxIndexableTempIndex;
  UINT16                         IndexableTempSize[4096];
  UINT16                         ImmediateConstantBufferSize;
  UINT                           PixelPosition[4][2];
  UINT64                         PixelCoverageMask[4];
  UINT64                         PixelDiscardedMask[4];
  UINT64                         PixelCoverageMaskAfterShader[4];
  UINT64                         PixelCoverageMaskAfterA2CSampleMask[4];
  UINT64                         PixelCoverageMaskAfterA2CSampleMaskDepth[4];
  UINT64                         PixelCoverageMaskAfterA2CSampleMaskDepthStencil[4];
  BOOL                           PSOutputsDepth;
  BOOL                           PSOutputsMask;
  D3D11_TRACE_GS_INPUT_PRIMITIVE GSInputPrimitive;
  BOOL                           GSInputsPrimitiveID;
  D3D11_TRACE_COMPONENT_MASK     HSOutputPatchConstantMask[32];
  D3D11_TRACE_COMPONENT_MASK     DSInputPatchConstantMask[32];
} D3D11_TRACE_STATS;

メンバー

TraceDesc

この構造体が統計を指定するシェーダートレースオブジェクトを記述する D3D11_SHADER_TRACE_DESC 構造体。

NumInvocationsInStamp

トレースのスタンプ内の呼び出しの数。頂点シェーダー、ハルシェーダー、ドメインシェーダー、ジオメトリシェーダー、コンピューティングシェーダーの場合、この値は常に 1 です。ピクセルシェーダーの場合、この値は 4 です。

TargetStampIndex

ターゲットスタンプのインデックス。頂点シェーダー、ハルシェーダー、ドメインシェーダー、ジオメトリシェーダー、コンピューティングシェーダーの場合、この値は常に 0 です。ただし、ピクセルシェーダーの場合、この値は、スタンプ内の 4 つのピクセルのうち、トレースのターゲットであるピクセルを示します。スタンプ内の他のピクセルのトレースを調べて、派生計算がどのように発生したかを判断できます。この決定を行うには、トレース間でレジスタを関連付けます。

NumTraceSteps

トレースのステップの合計数。この番号は、すべてのスタンプ呼び出しで同じです。

InputMask[32]

各入力 v# レジスタのコンポーネントトレースマスク。 D3D11_TRACE_COMPONENT_MASKの詳細については、「 D3D11_TRACE_VALUE」を参照してください。

頂点シェーダー、ジオメトリシェーダー、ピクセルシェーダー、ハルシェーダー、ドメインシェーダーの場合、有効な範囲は [0..31] です。コンピューティングシェーダーの場合、このメンバーは適用されません。また、ジオメトリシェーダーの入力は 2D インデックスが付けられます。たとえば、v[vertex][attribute] とします。この例では、[attribute] の範囲は [0..31] です。 [頂点] 軸は、 GSInputPrimitive メンバーによって決定されるすべての入力に対して同じサイズです。

同様に、ハルシェーダーとドメインシェーダーの入力は 2D インデックスが付けられます。たとえば、v[vertex][attribute] とします。この例では、[attribute] の範囲は [0..15] です。 [頂点] 軸は、すべての入力で同じサイズです。

OutputMask[32]

各出力 o# レジスタのコンポーネントトレースマスク。 D3D11_TRACE_COMPONENT_MASKの詳細については、「 D3D11_TRACE_VALUE」を参照してください。

頂点シェーダーとジオメトリシェーダーの場合、有効な範囲は [0..31] です。ピクセルシェーダーの場合、有効な範囲は [0..7] です。コンピューティングシェーダーの場合、このメンバーは適用されません。ハルシェーダーの出力コントロールポイントの場合、レジスタは 2D インデックスが付けられます。たとえば、ocp[vertex][attribute] とします。この例では、[attribute] の範囲は [0..31] です。 [頂点] 軸は、すべての入力で同じサイズです。

NumTemps

temp の数(つまり、宣言されている 4x32 ビット r# レジスタ)。

MaxIndexableTempIndex

宣言されているすべてのインデックス可能な temps x#[] の最大インデックス番号 #+1。それらがまばらに宣言されている場合 (たとえば、x3[12] と x200[30] のみ)、この値は 201 (200+1) です。

IndexableTempSize[4096]

インデックス可能な各 temp x#[numTemps] の temp の数。 Temp は MaxIndexableTempIndex メンバーの値までしか持てない。

ImmediateConstantBufferSize

イミディエイト定数バッファー内にある 4x32 ビット値 (存在する場合) の数。

PixelPosition[4]

PixelCoverageMask[4]