ホーム › Graphics.Imaging › IWICBitmapDecoderInfo
IWICBitmapDecoderInfo
COM公式ドキュメント
デコーダーに関する情報を提供するメソッドを公開します。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 23 HRESULT GetPatterns(DWORD cbSizePatterns, WICBitmapPattern* pPatterns, DWORD* pcPatterns, DWORD* pcbPatternsActual)
デコーダーがサポートするファイルパターンシグネチャを取得します。
| cbSizePatterns | DWORD | in | pPatterns 配列の配列サイズです。 |
| pPatterns | WICBitmapPattern* | outoptional | デコーダーがサポートする WICBitmapPattern オブジェクトのリストを受け取ります。 |
| pcPatterns | DWORD* | outoptional | デコーダーがサポートするパターンの数を受け取ります。 |
| pcbPatternsActual | DWORD* | out | デコーダーがサポートするすべてのパターンシグネチャを取得するために必要な実際のバッファサイズを受け取ります。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
すべてのパターンシグネチャを取得するには、まず pPatterns を NULL に設定してこのメソッドを呼び出し、pcbPatternsActual を通じて必要な実際のバッファサイズを取得する必要があります。
必要なバッファサイズがわかったら、必要なサイズのバッファを割り当て、割り当てたバッファを指定して GetPatterns を再度呼び出します。
指定したストリーム内のパターンをコーデックが認識するかどうかを示す値を取得します。
| pIStream | IStream* | in | パターンマッチングを行う対象のストリームです。 |
| pfMatches | BOOL* | out | パターンが一致する場合は TRUE、一致しない場合は FALSE を受け取るポインターです。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 25 HRESULT CreateInstance(IWICBitmapDecoder** ppIBitmapDecoder)
新しい IWICBitmapDecoder インスタンスを作成します。
| ppIBitmapDecoder | IWICBitmapDecoder** | out | IWICBitmapDecoder の新しいインスタンスへのポインターを受け取るポインターです。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IWICBitmapDecoderInfo "{D8CD007F-D08F-4191-9BFC-236EA7F0E4B5}" #usecom global IWICBitmapDecoderInfo IID_IWICBitmapDecoderInfo "{}" #comfunc global IWICBitmapDecoderInfo_GetPatterns 23 int,var,var,var #comfunc global IWICBitmapDecoderInfo_MatchesPattern 24 sptr,var #comfunc global IWICBitmapDecoderInfo_CreateInstance 25 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWICBitmapDecoderInfo "{D8CD007F-D08F-4191-9BFC-236EA7F0E4B5}" #usecom global IWICBitmapDecoderInfo IID_IWICBitmapDecoderInfo "{}" #comfunc global IWICBitmapDecoderInfo_GetPatterns 23 int,sptr,sptr,sptr #comfunc global IWICBitmapDecoderInfo_MatchesPattern 24 sptr,sptr #comfunc global IWICBitmapDecoderInfo_CreateInstance 25 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。