ID3D11ShaderReflection

シェーダーリフレクションインターフェイスは、シェーダーの情報にアクセスします。(ID3D11ShaderReflection)

シェーダーの ID3D11ShaderReflection インターフェイスは、D3DReflect を使用して取得できます。次のコードは、シェーダーから ID3D11ShaderReflection を取得する例です。

pd3dDevice->CreatePixelShader( pPixelShaderBuffer->GetBufferPointer(),
                               pPixelShaderBuffer->GetBufferSize(), g_pPSClassLinkage, &g_pPixelShader );

ID3D11ShaderReflection* pReflector = NULL; 
D3DReflect( pPixelShaderBuffer->GetBufferPointer(), pPixelShaderBuffer->GetBufferSize(), 
            IID_ID3D11ShaderReflection, (void**) &pReflector);

シェーダーの記述を取得します。(ID3D11ShaderReflection.GetDesc)

型: HRESULT

Direct3D 11 の戻り値コードのいずれかを返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

ID3D11ShaderReflection::GetConstantBufferByIndex (d3d11shader.h) メソッドは、インデックスを指定して定数バッファーを取得します。

型: ID3D11ShaderReflectionConstantBuffer*

定数バッファーへのポインター(ID3D11ShaderReflectionConstantBuffer インターフェイスを参照)。

定数バッファーは、スカラー定数またはテクスチャ定数をシェーダーに供給します。1 つのシェーダーは 1 つ以上の定数バッファーを使用できます。最良のパフォーマンスを得るには、更新頻度に基づいて定数をバッファーに分けてください。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

名前を指定して定数バッファーを取得します。(ID3D11ShaderReflection.GetConstantBufferByName)

型: ID3D11ShaderReflectionConstantBuffer*

定数バッファーへのポインター(ID3D11ShaderReflectionConstantBuffer インターフェイスを参照)。

定数バッファーは、スカラー定数またはテクスチャ定数をシェーダーに供給します。1 つのシェーダーは 1 つ以上の定数バッファーを使用できます。最良のパフォーマンスを得るには、更新頻度に基づいて定数をバッファーに分けてください。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

リソースがシェーダーにどのようにバインドされているかを示す記述を取得します。(ID3D11ShaderReflection.GetResourceBindingDesc)

型: HRESULT

Direct3D 11 の戻り値コードのいずれかを返します。

シェーダーは、実行可能コード(コンパイル済みの HLSL 関数)と、シェーダーに入力データを供給する一連のリソースで構成されます。GetResourceBindingDesc は、その一連のリソースのうち 1 つが、シェーダーへの入力としてどのようにバインドされているかについての情報を取得します。ResourceIndex パラメーターでリソースのインデックスを指定します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

シェーダーの入力パラメーターの記述を取得します。(ID3D11ShaderReflection.GetInputParameterDesc)

型: HRESULT

Direct3D 11 の戻り値コードのいずれかを返します。

入力パラメーターの記述は、シェーダーシグネチャとも呼ばれます。シェーダーシグネチャには、パラメーターの順序、データ型、パラメーターのセマンティクスなど、入力パラメーターに関する情報が含まれます。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

シェーダーの出力パラメーターの記述を取得します。(ID3D11ShaderReflection.GetOutputParameterDesc)

型: HRESULT

Direct3D 11 の戻り値コードのいずれかを返します。

出力パラメーターの記述は、シェーダーシグネチャとも呼ばれます。シェーダーシグネチャには、パラメーターの順序、データ型、パラメーターのセマンティクスなど、出力パラメーターに関する情報が含まれます。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

シェーダーのパッチ定数パラメーターの記述を取得します。

型: HRESULT

Direct3D 11 の戻り値コードのいずれかを返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

名前を指定して変数を取得します。(ID3D11ShaderReflection.GetVariableByName)

型: ID3D11ShaderReflectionVariable*

ID3D11ShaderReflectionVariable インターフェイスを返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

リソースがシェーダーにどのようにバインドされているかを示す記述を取得します。(ID3D11ShaderReflection.GetResourceBindingDescByName)

型: HRESULT

Direct3D 11 の戻り値コードのいずれかを返します。

シェーダーは、実行可能コード(コンパイル済みの HLSL 関数)と、シェーダーに入力データを供給する一連のリソースで構成されます。GetResourceBindingDescByName は、その一連のリソースのうち 1 つが、シェーダーへの入力としてどのようにバインドされているかについての情報を取得します。Name パラメーターでリソースの名前を指定します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

Mov 命令の数を取得します。(ID3D11ShaderReflection.GetMovInstructionCount)

型: UINT

Mov 命令の数を返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

Movc 命令の数を取得します。(ID3D11ShaderReflection.GetMovcInstructionCount)

型: UINT

Movc 命令の数を返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

変換命令の数を取得します。(ID3D11ShaderReflection.GetConversionInstructionCount)

型: UINT

変換命令の数を返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

ビット演算命令の数を取得します。(ID3D11ShaderReflection.GetBitwiseInstructionCount)

型: UINT

ビット演算命令の数。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

ジオメトリシェーダーの入力プリミティブの記述を取得します。(ID3D11ShaderReflection.GetGSInputPrimitive)

型: D3D_PRIMITIVE

入力プリミティブの記述。 D3D_PRIMITIVE_TOPOLOGY、 D3D11_PRIMITIVE_TOPOLOGY、または D3D10_PRIMITIVE_TOPOLOGY を参照してください。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

シェーダーがサンプル周波数シェーダーであるかどうかを示します。(ID3D11ShaderReflection.IsSampleFrequencyShader)

型: BOOL

シェーダーがサンプル周波数シェーダーの場合は true を返します。それ以外の場合は false を返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

シェーダー内のインターフェイススロットの数を取得します。(ID3D11ShaderReflection.GetNumInterfaceSlots)

型: UINT

シェーダー内のインターフェイススロットの数。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

最小の機能レベルを取得します。(ID3D11ShaderReflection.GetMinFeatureLevel)

型: HRESULT

Direct3D 11 の戻り値コードのいずれかを返します。

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

シェーダーのスレッドグループグリッドの X、Y、Z 各次元のサイズを、スレッド数単位で取得します。(ID3D11ShaderReflection.GetThreadGroupSize)

型: UINT

各次元のサイズの積を計算して、スレッドグループグリッドの合計サイズ(スレッド数単位)を返します。

*pSizeX * *pSizeY * *pSizeZ;

このメソッドのインターフェイスは、Out-of-Box DLL である D3DCompiler_xx.dll でホストされます。

コンピュートシェーダーを記述する際には、単一のスレッドグループの動作のみを定義します。複数のスレッドグループが必要な場合、それらを発行するのは ID3D11DeviceContext::Dispatch 呼び出しの役割です。

シェーダーの要件を示すフラグのグループを取得します。(ID3D11ShaderReflection.GetRequiresFlags)

型: UINT64

1 つ以上のシェーダー要件フラグの組み合わせを含む値。各フラグはシェーダーの要件を指定します。既定値の 0 は要件がないことを意味します。

D3D11Shader.h ヘッダーでは、シェーダー要件フラグは次のように定義されています。

#define D3D_SHADER_REQUIRES_DOUBLES                         0x00000001
#define D3D_SHADER_REQUIRES_EARLY_DEPTH_STENCIL             0x00000002
#define D3D_SHADER_REQUIRES_UAVS_AT_EVERY_STAGE             0x00000004
#define D3D_SHADER_REQUIRES_64_UAVS                         0x00000008
#define D3D_SHADER_REQUIRES_MINIMUM_PRECISION               0x00000010
#define D3D_SHADER_REQUIRES_11_1_DOUBLE_EXTENSIONS          0x00000020
#define D3D_SHADER_REQUIRES_11_1_SHADER_EXTENSIONS          0x00000040
#define D3D_SHADER_REQUIRES_LEVEL_9_COMPARISON_FILTERING    0x00000080