Win32 API 日本語リファレンス
ホーム › Graphics.Direct3D12 › ID3D12ShaderReflectionVariable

ID3D12ShaderReflectionVariable

COM
📘 Microsoft Learn (日本語) · English
IID8337a8a6-a216-444a-b2f4-314733a73aea自前メソッド開始 vtbl0

公式ドキュメント

変数へのアクセスを提供するシェーダーリフレクションインターフェイスです。(ID3D12ShaderReflectionVariable)

解説(Remarks)

シェーダーリフレクション変数インターフェイスを取得するには、ID3D12ShaderReflection::GetVariableByName などのメソッドを呼び出します。これは COM インターフェイスではないため、参照カウントや使用後のインターフェイスの解放を気にする必要はありません。

メソッド 4

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

vtbl 0 HRESULT GetDesc(D3D12_SHADER_VARIABLE_DESC* pDesc)

シェーダー変数の記述を取得します。

pDescD3D12_SHADER_VARIABLE_DESC*outシェーダー変数の記述へのポインター (D3D12_SHADER_VARIABLE_DESC を参照)。

戻り値

型: HRESULT

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

解説(Remarks)

このメソッドは、ID3D12ShaderReflectionVariable インターフェイスが有効かどうかを判定するために使用できます。変数が有効でない場合、このメソッドは E_FAIL を返します。

このメソッドのインターフェイスは、外部提供の DLL である D3DCompiler_xx.dll でホストされています。

vtbl 1 ID3D12ShaderReflectionType* GetType()

シェーダー変数の型を取得します。

戻り値

型: ID3D12ShaderReflectionType*

ID3D12ShaderReflectionType インターフェイスへのポインター。

解説(Remarks)

このメソッドのインターフェイスは、外部提供の DLL である D3DCompiler_xx.dll でホストされています。

vtbl 2 ID3D12ShaderReflectionConstantBuffer* GetBuffer()

現在の ID3D12ShaderReflectionVariable が属する ID3D12ShaderReflectionConstantBuffer を返します。

戻り値

型: ID3D12ShaderReflectionConstantBuffer*

現在の ID3D12ShaderReflectionVariable が属する ID3D12ShaderReflectionConstantBuffer へのポインターを返します。

vtbl 3 DWORD GetInterfaceSlot(DWORD uArrayIndex)

インターフェイスポインターを表す変数に対応するインターフェイススロットを取得します。(ID3D12ShaderReflectionVariable.GetInterfaceSlot)

uArrayIndexDWORDinスロット番号を取得する配列要素のインデックス。配列でない変数の場合、この値は 0 になります。

戻り値

型: UINT

インターフェイス配列内のインターフェイスのインデックスを返します。

解説(Remarks)

GetInterfaceSlot は、インターフェイスインスタンスに対応する動的リンケージ配列内のスロットを取得します。 返されたスロット番号は、インターフェイスインスタンスに特定のクラスインスタンスを設定するために使用します。 詳細については、HLSL のインターフェイスとクラスの概要を参照してください。

このメソッドのインターフェイスは、外部提供の DLL である D3DCompiler_xx.dll でホストされています。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ID3D12ShaderReflectionVariable "{8337A8A6-A216-444A-B2F4-314733A73AEA}"
#usecom global ID3D12ShaderReflectionVariable IID_ID3D12ShaderReflectionVariable "{}"
#comfunc global ID3D12ShaderReflectionVariable_GetDesc           0 var
#comfunc global ID3D12ShaderReflectionVariable_GetType           1
#comfunc global ID3D12ShaderReflectionVariable_GetBuffer         2
#comfunc global ID3D12ShaderReflectionVariable_GetInterfaceSlot  3 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。