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

ID3D11ShaderReflectionVariable

COM
📘 Microsoft Learn (日本語) · English
IID51f23923-f3e5-4bd1-91cb-606177d8db4c自前メソッド開始 vtbl0

公式ドキュメント

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

解説(Remarks)

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

メソッド 4

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

vtbl 0 HRESULT GetDesc(D3D11_SHADER_VARIABLE_DESC* pDesc)

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

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

戻り値

型: HRESULT

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

解説(Remarks)

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

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

vtbl 1 ID3D11ShaderReflectionType* GetType()

シェーダー変数の型を取得します。(ID3D11ShaderReflectionVariable.GetType)

戻り値

型: ID3D11ShaderReflectionType*

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

解説(Remarks)

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

vtbl 2 ID3D11ShaderReflectionConstantBuffer* GetBuffer()

このメソッドは、現在の ID3D11ShaderReflectionVariable のバッファーを返します。

戻り値

型: ID3D11ShaderReflectionConstantBuffer*

現在の ID3D11ShaderReflectionVariable の ID3D11ShaderReflectionConstantBuffer へのポインターを返します。

vtbl 3 DWORD GetInterfaceSlot(DWORD uArrayIndex)

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

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

戻り値

型: UINT

インターフェイス配列内における、そのインターフェイスのインデックスを返します。

解説(Remarks)

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

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

例

インターフェイススロットの取得と使用


ID3D11ShaderReflectionVariable* pAmbientLightingVar = pReflector->GetVariableByName("g_abstractAmbientLighting");
g_iAmbientLightingOffset = pAmbientLightingVar->GetInterfaceSlot(0);
g_pPSClassLinkage->GetClassInstance( "g_hemiAmbientLight", 0, &g_pHemiAmbientLightClass );
g_dynamicLinkageArray[g_iAmbientLightingOffset] = g_pHemiAmbientLightClass; 
...
pd3dImmediateContext->PSSetShader( g_pPixelShader, g_dynamicLinkageArray, g_iNumPSInterfaces );
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ID3D11ShaderReflectionVariable "{51F23923-F3E5-4BD1-91CB-606177D8DB4C}"
#usecom global ID3D11ShaderReflectionVariable IID_ID3D11ShaderReflectionVariable "{}"
#comfunc global ID3D11ShaderReflectionVariable_GetDesc           0 var
#comfunc global ID3D11ShaderReflectionVariable_GetType           1
#comfunc global ID3D11ShaderReflectionVariable_GetBuffer         2
#comfunc global ID3D11ShaderReflectionVariable_GetInterfaceSlot  3 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。