ホーム › Graphics.Direct3D12 › ID3D12FunctionReflection

ID3D12FunctionReflection

COM

IID1108795c-2772-4ba9-b2a8-d464dc7e2799自前メソッド開始 vtbl0

公式ドキュメント

関数の情報にアクセスするための関数リフレクションインターフェイスです。(ID3D12FunctionReflection)

解説(Remarks)

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

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

メソッド 7

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

vtbl 0 HRESULT GetDesc(D3D12_FUNCTION_DESC* pDesc)

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

pDesc

D3D12_FUNCTION_DESC*

out

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

戻り値

型: HRESULT

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

vtbl 1 ID3D12ShaderReflectionConstantBuffer* GetConstantBufferByIndex(DWORD BufferIndex)

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

BufferIndex

DWORD

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

戻り値

型: ID3D12ShaderReflectionConstantBuffer*

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

解説(Remarks)

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

vtbl 2 ID3D12ShaderReflectionConstantBuffer* GetConstantBufferByName(LPSTR Name)

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

Name

LPSTR

定数バッファー名です。

戻り値

型: ID3D12ShaderReflectionConstantBuffer*

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

解説(Remarks)

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

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

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

戻り値

型: HRESULT

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

解説(Remarks)

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

vtbl 4 ID3D12ShaderReflectionVariable* GetVariableByName(LPSTR Name)

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

Name

LPSTR

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

戻り値

型: ID3D12ShaderReflectionVariable*

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

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

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

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

戻り値

型: HRESULT

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

解説(Remarks)

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

vtbl 6 ID3D12FunctionParameterReflection* GetFunctionParameter(INT ParameterIndex)

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

ParameterIndex

INT

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

戻り値

型: ID3D12FunctionParameterReflection*

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

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ID3D12FunctionReflection "{1108795C-2772-4BA9-B2A8-D464DC7E2799}"
#usecom global ID3D12FunctionReflection IID_ID3D12FunctionReflection "{}"
#comfunc global ID3D12FunctionReflection_GetDesc                       0 var
#comfunc global ID3D12FunctionReflection_GetConstantBufferByIndex      1 int
#comfunc global ID3D12FunctionReflection_GetConstantBufferByName       2 str
#comfunc global ID3D12FunctionReflection_GetResourceBindingDesc        3 int,var
#comfunc global ID3D12FunctionReflection_GetVariableByName             4 str
#comfunc global ID3D12FunctionReflection_GetResourceBindingDescByName  5 str,var
#comfunc global ID3D12FunctionReflection_GetFunctionParameter          6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_ID3D12FunctionReflection "{1108795C-2772-4BA9-B2A8-D464DC7E2799}"
#usecom global ID3D12FunctionReflection IID_ID3D12FunctionReflection "{}"
#comfunc global ID3D12FunctionReflection_GetDesc                       0 sptr
#comfunc global ID3D12FunctionReflection_GetConstantBufferByIndex      1 int
#comfunc global ID3D12FunctionReflection_GetConstantBufferByName       2 str
#comfunc global ID3D12FunctionReflection_GetResourceBindingDesc        3 int,sptr
#comfunc global ID3D12FunctionReflection_GetVariableByName             4 str
#comfunc global ID3D12FunctionReflection_GetResourceBindingDescByName  5 str,sptr
#comfunc global ID3D12FunctionReflection_GetFunctionParameter          6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。