ID2D1EffectContext
COM公式ドキュメント
エフェクトおよびトランスフォームの作成者向けに、ファクトリメソッドやその他の状態管理を提供します。(ID2D1EffectContext)
解説(Remarks)
このインターフェイスは、ID2D1EffectImpl::Initialize メソッドを通じてエフェクトの実装に渡されます。アプリケーションがこのインターフェイスに安易にアクセスするのを防ぎ、パブリックインターフェイスとプライベートインターフェイスの間で参照カウントを分離するため、ID2D1DeviceContext と ID2D1EffectContext の間で QueryInterface を呼び出すことはできません。
ID2D1Effect::Initialize を呼び出すたびに、異なる ID2D1EffectContext インターフェイスが提供されます。このインターフェイスは、エフェクトのリソース割り当てを追跡します。エフェクトが解放されると、対応する割り当ても解放されます。
メソッド 21
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ドット/インチ(dpi)またはピクセルのいずれかで表される可能性のあるプロパティに対して、エフェクトが使用する単位マッピングを取得します。
| dpiX | FLOAT* | out | x 軸方向の dpi。 |
| dpiY | FLOAT* | out | y 軸方向の dpi。 |
解説(Remarks)
D2D1_UNIT_MODE が D2D1_UNIT_MODE_PIXELS の場合、dpiX と dpiY の両方が 96 に設定されます。
指定したクラス ID に対応する Direct2D エフェクトを作成します。
| effectId | GUID* | in | エフェクトを作成するための、組み込みまたは登録済みのエフェクト ID。エフェクト ID の一覧については、Built-in Effects を参照してください。 |
| effect | ID2D1Effect** | out | このメソッドが返るときに、エフェクトへのポインターのアドレスが格納されます。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効な値がメソッドに渡されました。 |
| D3DERR_OUTOFVIDEOMEMORY | この操作を実行するのに十分なディスプレイメモリが Direct3D にありません。 |
| D2DERR_EFFECT_IS_NOT_REGISTERED | 指定したエフェクトはシステムに登録されていません。 |
解説(Remarks)
作成されたエフェクトは、そのエフェクトの作成元となった DLL の参照カウントを行いません。このエフェクトがロードされている間に呼び出し側がエフェクトの登録を解除した場合、その結果としての動作は予測できません。
指定した一覧の中で、デバイスがサポートする最大の機能レベルを示します。
| featureLevels | D3D_FEATURE_LEVEL* | in | アプリケーションが指定する機能レベル。 |
| featureLevelsCount | DWORD | in | アプリケーションが指定する機能レベルの数。 |
| maximumSupportedFeatureLevel | D3D_FEATURE_LEVEL* | out | featureLevels の一覧の中で、D2D デバイスがサポートする最大の機能レベル。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
| D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES | 指定したレベルはいずれもサポートされていません。 |
エフェクトグラフを単一のトランスフォームノードにラップし、トランスフォームグラフに挿入します。これにより、あるエフェクトが他のエフェクトを集約できるようになります。
| effect | ID2D1Effect* | in | トランスフォームノードにラップするエフェクト。 |
| transformNode | ID2D1TransformNode** | out | エフェクトグラフをカプセル化する、返されるトランスフォームノード。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
トランスフォームグラフに挿入できるブレンドトランスフォームを作成します。
| numInputs | DWORD | in | ブレンドトランスフォームへの入力の数。 |
| blendDescription | D2D1_BLEND_DESCRIPTION* | in | 作成するブレンドトランスフォームを記述します。 |
| transform | ID2D1BlendTransform** | out | 返されるブレンドトランスフォーム。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
渡された拡張モードに基づいて、入力をあらゆる方向に無限に拡張するトランスフォームを作成します。
| extendModeX | D2D1_EXTEND_MODE | in | X 軸方向の拡張モード。 |
| extendModeY | D2D1_EXTEND_MODE | in | Y 軸方向の拡張モード。 |
| transform | ID2D1BorderTransform** | out | 返されるトランスフォーム。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
オフセットトランスフォームを作成して返します。
| offset | POINT | in | オフセット量。 |
| transform | ID2D1OffsetTransform** | out | このメソッドが返るときに、オフセットトランスフォームオブジェクトへのポインターのアドレスが格納されます。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
解説(Remarks)
オフセットトランスフォームは、レンダリングパスを挿入することなく入力ビットマップをオフセットするために使用します。トランスフォームがピクセルに整列したトランスフォームとして評価される場合、オフセットトランスフォームはアフィントランスフォームによって自動的に挿入されます。
境界調整トランスフォームを作成して返します。
| outputRectangle | RECT* | in | 境界調整トランスフォームの初期出力矩形。 |
| transform | ID2D1BoundsAdjustmentTransform** | out | 返される境界調整トランスフォーム。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
解説(Remarks)
サポートトランスフォームは、次の 2 つの異なる目的で使用できます。
- 入力画像のある領域が、既に透明な黒であることを示すため。これにより、ビットマップのレンダリング効率を高めることができます。 Note 指定した領域が透明な黒のピクセルのみを含んでいない場合、レンダリング結果は未定義になります。
- 入力画像のサイズを拡大するため。拡大された領域は透明な黒として扱われます。
指定したシェーダーを、その一意の ID を使ってロードします。(ID2D1EffectContext.LoadPixelShader)
| shaderId | GUID* | in | シェーダーを識別する一意の ID。 |
| shaderBuffer | BYTE* | in | 登録するシェーダーを格納するバッファー。 |
| shaderBufferCount | DWORD | in | シェーダーバッファーのサイズ(バイト単位)。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
解説(Remarks)
指定するシェーダーはコンパイル済みである必要があり、生の HLSL コードであってはなりません。
指定したシェーダーを、その一意の ID を使ってロードします。(ID2D1EffectContext.LoadVertexShader)
| resourceId | GUID* | in | シェーダーを識別する一意の ID。 |
| shaderBuffer | BYTE* | in | 登録するシェーダーを格納するバッファー。 |
| shaderBufferCount | DWORD | in | シェーダーバッファーのサイズ(バイト単位)。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
解説(Remarks)
指定するシェーダーはコンパイル済みである必要があり、生の HLSL コードであってはなりません。
指定したシェーダーを、その一意の ID を使ってロードします。(ID2D1EffectContext.LoadComputeShader)
| resourceId | GUID* | in | シェーダーを識別する一意の ID。 |
| shaderBuffer | BYTE* | in | 登録するシェーダーを格納するバッファー。 |
| shaderBufferCount | DWORD | in | シェーダーバッファーのサイズ(バイト単位)。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
解説(Remarks)
指定するシェーダーはコンパイル済みである必要があり、生の HLSL コードであってはなりません。
指定したシェーダーがロードされているかどうかをテストします。
| shaderId | GUID* | in | シェーダーを識別する一意の ID。 |
戻り値
型: BOOL
シェーダーがロードされているかどうか。
リソース ID が指定されているかどうかに応じて、指定したリソーステクスチャを作成または検索します。
| resourceId | GUID* | inoptional | ルックアップテーブルを識別する一意の ID への、省略可能なポインター。 |
| resourceTextureProperties | D2D1_RESOURCE_TEXTURE_PROPERTIES* | in | リソーステクスチャの作成に使用するプロパティ。 |
| data | BYTE* | inoptional | リソーステクスチャにロードする省略可能なデータ。 |
| strides | DWORD* | inoptional | 次元に応じてリソーステクスチャ内を進むためのストライドへの、省略可能なポインター。 |
| dataSize | DWORD | in | データのサイズ(バイト単位)。 |
| resourceTexture | ID2D1ResourceTexture** | out | Direct2D エフェクトでリソースとして使用できる、返されるテクスチャ。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
指定したリソーステクスチャが、同じ GUID を使って ID2D1EffectContext::CreateResourceTexture で既に作成されている場合に、それを検索します。
| resourceId | GUID* | in | リソーステクスチャを識別する一意の ID。 |
| resourceTexture | ID2D1ResourceTexture** | out | Direct2D エフェクトでリソースとして使用できる、返されるテクスチャ。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_NOTFOUND | 要求されたリソーステクスチャが見つかりませんでした。 |
頂点バッファーを作成する、または標準の頂点バッファーを検索し、必要に応じて頂点で初期化します。
| vertexBufferProperties | D2D1_VERTEX_BUFFER_PROPERTIES* | in | 頂点バッファーと頂点シェーダーを記述するために使用するプロパティ。 |
| resourceId | GUID* | inoptional | 頂点バッファーを識別する一意の ID。 |
| customVertexBufferProperties | D2D1_CUSTOM_VERTEX_BUFFER_PROPERTIES* | inoptional | カスタム頂点バッファーを定義するために使用するプロパティ。組み込みの頂点シェーダーを使用する場合、このプロパティを指定する必要はありません。 |
| buffer | ID2D1VertexBuffer** | out | 返される頂点バッファー。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
指定した頂点バッファーが、同じ GUID を使って ID2D1EffectContext::CreateVertexBuffer で既に作成されている場合に、それを検索します。
| resourceId | GUID* | in | 頂点バッファーを識別する一意の ID。 |
| buffer | ID2D1VertexBuffer** | out | Direct2D エフェクトでリソースとして使用できる、返される頂点バッファー。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_NOTFOUND | 要求された頂点バッファーが見つかりませんでした。 |
色空間からカラーコンテキストを作成します。
| space | D2D1_COLOR_SPACE | in | 作成するカラーコンテキストの色空間。 |
| profile | BYTE* | inoptional | space が D2D1_COLOR_SPACE_CUSTOM の場合に、カラーコンテキストの初期化に使用する ICC プロファイルのバイト列を格納するバッファー。その他の型の場合、このパラメーターは無視され、NULL に設定する必要があります。 |
| profileSize | DWORD | in | Profile のサイズ(バイト単位)。 |
| colorContext | ID2D1ColorContext** | out | このメソッドが返るときに、新しいカラーコンテキストオブジェクトへのポインターのアドレスが格納されます。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効な値がメソッドに渡されました。 |
指定したファイル名からロードすることで、カラーコンテキストを作成します。プロファイルのバイト列は、filename で指定したファイルの内容です。
| filename | LPWSTR | in | カラーコンテキストの初期化に使用するプロファイルのバイト列を含むファイルへのパス。 |
| colorContext | ID2D1ColorContext** | out | このメソッドが返るときに、新しいカラーコンテキストへのポインターのアドレスが格納されます。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効な値がメソッドに渡されました。 |
IWICColorContext からカラーコンテキストを作成します。作成されるコンテキストの D2D1ColorContext の色空間は状況によって異なります。詳細については「解説」を参照してください。(ID2D1EffectContext.CreateColorContextFromWicColorContext)
| wicColorContext | IWICColorContext* | in | カラーコンテキストの初期化に使用する IWICColorContext。 |
| colorContext | ID2D1ColorContext** | out | このメソッドが返るときに、新しいカラーコンテキストへのポインターのアドレスが格納されます。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効な値がメソッドに渡されました。 |
解説(Remarks)
新しいカラーコンテキストは、D2D1_BITMAP_PROPERTIES1 で使用して、作成したビットマップのカラーコンテキストを初期化できます。プロファイルヘッダーの model フィールドを検査して、このプロファイルが sRGB か scRGB かを判定し、それに応じて色空間が更新されます。それ以外の場合、色空間はカスタムになります。
オプションの機能が D3D デバイスでサポートされているかどうかを示します。
| feature | D2D1_FEATURE | in | サポート状況を照会する機能。 |
| featureSupportData | void* | out | 機能がどのようにサポートされているか、またはサポートされているかどうかに関する情報を示す構造体。 |
| featureSupportDataSize | DWORD | in | featureSupportData パラメーターのサイズ。 |
戻り値
型: HRESULT
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生しませんでした。 |
| E_OUTOFMEMORY | 呼び出しを完了するのに十分なメモリを Direct2D が割り当てられませんでした。 |
| E_INVALIDARG | 無効なパラメーターが、値を返す関数に渡されました。 |
バッファー精度が、基盤となる Direct2D デバイスでサポートされているかどうかを示します。
| bufferPrecision | D2D1_BUFFER_PRECISION | in | チェックするバッファー精度。 |
戻り値
型: BOOL
バッファー精度がサポートされている場合は TRUE を返します。バッファー精度がサポートされていない場合は FALSE を返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ID2D1EffectContext "{3D9F916B-27DC-4AD7-B4F1-64945340F563}" #usecom global ID2D1EffectContext IID_ID2D1EffectContext "{}" #comfunc global ID2D1EffectContext_GetDpi 3 var,var #comfunc global ID2D1EffectContext_CreateEffect 4 var,sptr #comfunc global ID2D1EffectContext_GetMaximumSupportedFeatureLevel 5 var,int,var #comfunc global ID2D1EffectContext_CreateTransformNodeFromEffect 6 sptr,sptr #comfunc global ID2D1EffectContext_CreateBlendTransform 7 int,var,sptr #comfunc global ID2D1EffectContext_CreateBorderTransform 8 int,int,sptr #comfunc global ID2D1EffectContext_CreateOffsetTransform 9 int,sptr #comfunc global ID2D1EffectContext_CreateBoundsAdjustmentTransform 10 var,sptr #comfunc global ID2D1EffectContext_LoadPixelShader 11 var,var,int #comfunc global ID2D1EffectContext_LoadVertexShader 12 var,var,int #comfunc global ID2D1EffectContext_LoadComputeShader 13 var,var,int #comfunc global ID2D1EffectContext_IsShaderLoaded 14 var #comfunc global ID2D1EffectContext_CreateResourceTexture 15 var,var,var,var,int,sptr #comfunc global ID2D1EffectContext_FindResourceTexture 16 var,sptr #comfunc global ID2D1EffectContext_CreateVertexBuffer 17 var,var,var,sptr #comfunc global ID2D1EffectContext_FindVertexBuffer 18 var,sptr #comfunc global ID2D1EffectContext_CreateColorContext 19 int,var,int,sptr #comfunc global ID2D1EffectContext_CreateColorContextFromFilename 20 wstr,sptr #comfunc global ID2D1EffectContext_CreateColorContextFromWicColorContext 21 sptr,sptr #comfunc global ID2D1EffectContext_CheckFeatureSupport 22 int,sptr,int #comfunc global ID2D1EffectContext_IsBufferPrecisionSupported 23 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ID2D1EffectContext "{3D9F916B-27DC-4AD7-B4F1-64945340F563}" #usecom global ID2D1EffectContext IID_ID2D1EffectContext "{}" #comfunc global ID2D1EffectContext_GetDpi 3 sptr,sptr #comfunc global ID2D1EffectContext_CreateEffect 4 sptr,sptr #comfunc global ID2D1EffectContext_GetMaximumSupportedFeatureLevel 5 sptr,int,sptr #comfunc global ID2D1EffectContext_CreateTransformNodeFromEffect 6 sptr,sptr #comfunc global ID2D1EffectContext_CreateBlendTransform 7 int,sptr,sptr #comfunc global ID2D1EffectContext_CreateBorderTransform 8 int,int,sptr #comfunc global ID2D1EffectContext_CreateOffsetTransform 9 int,sptr #comfunc global ID2D1EffectContext_CreateBoundsAdjustmentTransform 10 sptr,sptr #comfunc global ID2D1EffectContext_LoadPixelShader 11 sptr,sptr,int #comfunc global ID2D1EffectContext_LoadVertexShader 12 sptr,sptr,int #comfunc global ID2D1EffectContext_LoadComputeShader 13 sptr,sptr,int #comfunc global ID2D1EffectContext_IsShaderLoaded 14 sptr #comfunc global ID2D1EffectContext_CreateResourceTexture 15 sptr,sptr,sptr,sptr,int,sptr #comfunc global ID2D1EffectContext_FindResourceTexture 16 sptr,sptr #comfunc global ID2D1EffectContext_CreateVertexBuffer 17 sptr,sptr,sptr,sptr #comfunc global ID2D1EffectContext_FindVertexBuffer 18 sptr,sptr #comfunc global ID2D1EffectContext_CreateColorContext 19 int,sptr,int,sptr #comfunc global ID2D1EffectContext_CreateColorContextFromFilename 20 wstr,sptr #comfunc global ID2D1EffectContext_CreateColorContextFromWicColorContext 21 sptr,sptr #comfunc global ID2D1EffectContext_CheckFeatureSupport 22 int,sptr,int #comfunc global ID2D1EffectContext_IsBufferPrecisionSupported 23 int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。