ホーム › Graphics.Direct3D11 › ID3D11ClassLinkage

ID3D11ClassLinkage

COM

IIDddf57cba-9543-46e4-a12b-f207a0fe7fed継承元ID3D11DeviceChild自前メソッド開始 vtbl7

公式ドキュメント

このインターフェイスは HLSL の動的リンクをカプセル化します。

解説(Remarks)

クラスリンケージオブジェクトは、最大 64K 個の取得済みインスタンスを保持できます。取得済みインスタンスとは、そのリンケージオブジェクトを使用して作成された任意のシェーダー内の変数名を参照するハンドルです。クラスリンケージオブジェクトを使用してシェーダーを作成すると、ランタイムはこれらのインスタンスを収集し、クラスリンケージオブジェクトに格納します。クラスリンケージオブジェクトの使用方法の詳細については、「Storing Variables and Types for Shaders to Share」を参照してください。

ID3D11ClassLinkage オブジェクトは、ID3D11Device::CreateClassLinkage メソッドを使用して作成します。

メソッド 2

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

vtbl 7 HRESULT GetClassInstance(LPSTR pClassInstanceName, DWORD InstanceIndex, ID3D11ClassInstance** ppInstance)

指定した HLSL クラスを表すクラスインスタンスオブジェクトを取得します。

pClassInstanceName	LPSTR	in	クラスインスタンスを取得する対象のクラス名。
InstanceIndex	DWORD	in	クラスインスタンスのインデックス。
ppInstance	ID3D11ClassInstance**	out	初期化する ID3D11ClassInstance インターフェイスへのポインターのアドレス。

戻り値

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合は、Direct3D 11 リターンコードのいずれかを返します。

解説(Remarks)

ID3D11ClassLinkage インターフェイスの使用方法の詳細については、「Dynamic Linking」を参照してください。

クラスインスタンスを ID3D11ClassLinkage::GetClassInstance でランタイムから利用できるようにするには、そのクラスインスタンスに少なくとも 1 つのデータメンバーが必要です。メンバーを持たないインスタンスは、サイズ 0 のオブジェクトとしてコンパイル済みシェーダー BLOB から最適化により除去されます。データメンバーを持たないクラスの場合は、代わりに ID3D11ClassLinkage::CreateClassInstance を使用してください。

Windows Phone 8: この API はサポートされています。

vtbl 8 HRESULT CreateClassInstance(LPSTR pClassTypeName, DWORD ConstantBufferOffset, DWORD ConstantVectorOffset, DWORD TextureOffset, DWORD SamplerOffset, ID3D11ClassInstance** ppInstance)

HLSL のクラスインスタンスを表すクラスインスタンスオブジェクトを初期化します。

pClassTypeName	LPSTR	in	初期化するクラスの型名。
ConstantBufferOffset	DWORD	in	クラスデータを格納する定数バッファーを識別します。
ConstantVectorOffset	DWORD	in	クラスデータが始まる位置を示す、定数バッファーの先頭からの 4 成分ベクトル単位のオフセット。したがって、これはバイト単位のオフセットではありません。
TextureOffset	DWORD	in	最初のテクスチャのテクスチャスロット。オフセット以降に複数のテクスチャが続く場合があります。
SamplerOffset	DWORD	in	最初のサンプラーのサンプラースロット。オフセット以降に複数のサンプラーが続く場合があります。
ppInstance	ID3D11ClassInstance**	out	初期化する ID3D11ClassInstance インターフェイスへのポインターのアドレス。

戻り値

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合は、次の Direct3D 11 リターンコードのいずれかを返します。

解説(Remarks)

インスタンスは、シェーダーの作成前でも作成後でも生成 (または取得) できます。クラスインスタンスの取得と、そのインスタンスを使用するシェーダーの作成には、同じシェーダーリンケージオブジェクトを使用してください。

ID3D11ClassLinkage インターフェイスの使用方法の詳細については、「Dynamic Linking」を参照してください。

Windows Phone 8: この API はサポートされています。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ID3D11ClassLinkage "{DDF57CBA-9543-46E4-A12B-F207A0FE7FED}"
#usecom global ID3D11ClassLinkage IID_ID3D11ClassLinkage "{}"
#comfunc global ID3D11ClassLinkage_GetClassInstance     7 str,int,sptr
#comfunc global ID3D11ClassLinkage_CreateClassInstance  8 str,int,int,int,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。