ホーム › AI.MachineLearning.DirectML › IDMLOperatorInitializer

IDMLOperatorInitializer

COM

📘 Microsoft Learn (日本語) · English

IID427c1113-435c-469c-8676-4d5dd072f813継承元IDMLDispatchable自前メソッド開始 vtbl9

公式ドキュメント

コンパイル済みオペレーターを初期化することを目的とした特殊なオブジェクトを表します。このオブジェクトのインスタンスを作成するには、IDMLDevice::CreateOperatorInitializer を呼び出します。

解説(Remarks)

オペレーター初期化子は再利用可能です。あるインスタンスを使って一連のオペレーターを初期化した後、別のコンパイル済みオペレーターのセットをターゲットとしてそれをリセットできます。

初期化子を実行する際に期待されるバインディングは次のとおりです。

入力は、初期化子の作成時またはリセット時に最初にオペレーターを指定した順序で、各ターゲットオペレーターにつき 1 つのバッファー配列バインディングである必要があります。各バッファー配列バインディング自体は、対応するオペレーターの入力数と等しいサイズを持つ必要があります。あるいは、そのターゲットオペレーターの初期化に入力をバインドしない場合は、バインディングに NONE を指定できます。
出力は、初期化子の作成時またはリセット時に最初にオペレーターを指定した順序で、各ターゲットオペレーターの永続リソースである必要があります。
ディスパッチ可能なオブジェクト(オペレーター初期化子またはコンパイル済みオペレーター)全般と同様に、初期化子は一時リソースを必要とする場合があります。一時リソースの必要なサイズを判断するには、IDMLDispatchable::GetBindingProperties を呼び出してください。
オペレーター初期化子が永続リソースを必要とすることはありません。したがって、オペレーター初期化子に対して IDMLDispatchable::GetBindingProperties を呼び出すと、常に PersistentResourceSize として 0 が返されます。

オペレーター初期化子自体は初期化する必要はありません。GPU の初期化はコンパイル済みオペレーターにのみ適用されます。

メソッド 1

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

vtbl 9 HRESULT Reset(DWORD operatorCount, IDMLCompiledOperator** operators)

新しいオペレーターのセットの初期化を処理するために、初期化子をリセットします。

operatorCount	DWORD	in	このパラメーターは、operators パラメーターで渡される配列の要素数を決定します。
operators	IDMLCompiledOperator**	inoptional	初期化子が初期化すべきオペレーターを格納した、IDMLCompiledOperator ポインターの定数配列への省略可能なポインター。

戻り値

型: HRESULT

このメソッドが成功すると、S_OK を返します。それ以外の場合は、HRESULT エラーコードを返します。

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