ホーム › Graphics.Direct3D11 › ID3D11FunctionReflection

ID3D11FunctionReflection

COM

IID207bcecb-d683-4a06-a8a3-9b149b9f73a4自前メソッド開始 vtbl0

公式ドキュメント

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

解説(Remarks)

関数リフレクションインターフェイスを取得するには、ID3D11LibraryReflection::GetFunctionByIndex を呼び出します。これは COM インターフェイスではないため、参照カウントや、使い終わった後のインターフェイスの解放について気にする必要はありません。

メモ ID3D11FunctionReflection には D3dcompiler_47.dll 以降のバージョンの DLL が必要です。

メソッド 7

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 0 HRESULT GetDesc(D3D11_FUNCTION_DESC* pDesc)

関数の関数記述子構造体を設定します。(ID3D11FunctionReflection.GetDesc)

pDesc

D3D11_FUNCTION_DESC*

out

関数の説明を受け取る D3D11_FUNCTION_DESC 構造体へのポインターです。

戻り値

型: HRESULT

Direct3D 11 リターンコードのいずれかを返します。

vtbl 1 ID3D11ShaderReflectionConstantBuffer* GetConstantBufferByIndex(DWORD BufferIndex)

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

BufferIndex

DWORD

0 から始まるインデックスです。

戻り値

型: ID3D11ShaderReflectionConstantBuffer*

定数バッファーを表す ID3D11ShaderReflectionConstantBuffer インターフェイスへのポインターです。

解説(Remarks)

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

vtbl 2 ID3D11ShaderReflectionConstantBuffer* GetConstantBufferByName(LPSTR Name)

関数の定数バッファーを名前で取得します。(ID3D11FunctionReflection.GetConstantBufferByName)

Name

LPSTR

定数バッファーの名前です。

戻り値

型: ID3D11ShaderReflectionConstantBuffer*

定数バッファーを表す ID3D11ShaderReflectionConstantBuffer インターフェイスへのポインターです。

解説(Remarks)

vtbl 3 HRESULT GetResourceBindingDesc(DWORD ResourceIndex, D3D11_SHADER_INPUT_BIND_DESC* pDesc)

リソースが関数にどのようにバインドされているかの説明を取得します。(ID3D11FunctionReflection.GetResourceBindingDesc)

ResourceIndex	DWORD	in	0 から始まるリソースのインデックスです。
pDesc	D3D11_SHADER_INPUT_BIND_DESC*	out	リソースの入力バインドを記述する D3D11_SHADER_INPUT_BIND_DESC 構造体へのポインターです。

戻り値

型: HRESULT

Direct3D 11 リターンコードのいずれかを返します。

解説(Remarks)

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

vtbl 4 ID3D11ShaderReflectionVariable* GetVariableByName(LPSTR Name)

変数を名前で取得します。(ID3D11FunctionReflection.GetVariableByName)

Name

LPSTR

変数名を含む文字列へのポインターです。

戻り値

型: ID3D11ShaderReflectionVariable*

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

vtbl 5 HRESULT GetResourceBindingDescByName(LPSTR Name, D3D11_SHADER_INPUT_BIND_DESC* pDesc)

リソースが関数にどのようにバインドされているかの説明を取得します。(ID3D11FunctionReflection.GetResourceBindingDescByName)

Name	LPSTR	in	リソースの定数バッファー名です。
pDesc	D3D11_SHADER_INPUT_BIND_DESC*	out	リソースの入力バインドを記述する D3D11_SHADER_INPUT_BIND_DESC 構造体へのポインターです。

戻り値

型: HRESULT

Direct3D 11 リターンコードのいずれかを返します。

解説(Remarks)

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

vtbl 6 ID3D11FunctionParameterReflection* GetFunctionParameter(INT ParameterIndex)

関数パラメーターのリフレクターを取得します。(ID3D11FunctionReflection.GetFunctionParameter)

ParameterIndex

INT

取得する関数パラメーターリフレクターの、0 から始まるインデックスです。

戻り値

型: ID3D11FunctionParameterReflection*

関数パラメーターリフレクターを表す ID3D11FunctionParameterReflection インターフェイスへのポインターです。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ID3D11FunctionReflection "{207BCECB-D683-4A06-A8A3-9B149B9F73A4}"
#usecom global ID3D11FunctionReflection IID_ID3D11FunctionReflection "{}"
#comfunc global ID3D11FunctionReflection_GetDesc                       0 var
#comfunc global ID3D11FunctionReflection_GetConstantBufferByIndex      1 int
#comfunc global ID3D11FunctionReflection_GetConstantBufferByName       2 str
#comfunc global ID3D11FunctionReflection_GetResourceBindingDesc        3 int,var
#comfunc global ID3D11FunctionReflection_GetVariableByName             4 str
#comfunc global ID3D11FunctionReflection_GetResourceBindingDescByName  5 str,var
#comfunc global ID3D11FunctionReflection_GetFunctionParameter          6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_ID3D11FunctionReflection "{207BCECB-D683-4A06-A8A3-9B149B9F73A4}"
#usecom global ID3D11FunctionReflection IID_ID3D11FunctionReflection "{}"
#comfunc global ID3D11FunctionReflection_GetDesc                       0 sptr
#comfunc global ID3D11FunctionReflection_GetConstantBufferByIndex      1 int
#comfunc global ID3D11FunctionReflection_GetConstantBufferByName       2 str
#comfunc global ID3D11FunctionReflection_GetResourceBindingDesc        3 int,sptr
#comfunc global ID3D11FunctionReflection_GetVariableByName             4 str
#comfunc global ID3D11FunctionReflection_GetResourceBindingDescByName  5 str,sptr
#comfunc global ID3D11FunctionReflection_GetFunctionParameter          6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。