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

IWICMetadataHandlerInfo

COM
📘 Microsoft Learn (日本語) · English
IIDaba958bf-c672-44d1-8d61-ce6df2e682c2継承元IWICComponentInfo自前メソッド開始 vtbl11

公式ドキュメント

登録されたメタデータハンドラーに関する基本的な情報を提供するメソッドを公開します。

メソッド 7

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

vtbl 11 HRESULT GetMetadataFormat(GUID* pguidMetadataFormat)

メタデータハンドラーのメタデータ形式を取得します。

pguidMetadataFormatGUID*outメタデータ形式の GUID を受け取るポインター。

戻り値

型: HRESULT

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

vtbl 12 HRESULT GetContainerFormats(DWORD cContainerFormats, GUID* pguidContainerFormats, DWORD* pcchActual)

メタデータハンドラーがサポートするコンテナー形式を取得します。

cContainerFormatsDWORDinpguidContainerFormats 配列のサイズ。
pguidContainerFormatsGUID*inoutメタデータハンドラーがサポートするコンテナー形式を受け取る配列へのポインター。
pcchActualDWORD*out

配列に追加された GUID の実際の数。

サポートされているコンテナー形式の数を取得するには、pguidContainerFormats に NULL を渡します。

戻り値

型: HRESULT

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

vtbl 13 HRESULT GetDeviceManufacturer(DWORD cchDeviceManufacturer, LPWSTR wzDeviceManufacturer, DWORD* pcchActual)

メタデータハンドラーのデバイス製造元を取得します。

cchDeviceManufacturerDWORDinwzDeviceManufacturer バッファーのサイズ。
wzDeviceManufacturerLPWSTRinoutデバイス製造元の名前を受け取るバッファーへのポインター。
pcchActualDWORD*outデバイス製造元の名前全体を取得するために必要な実際の文字列バッファー長。

戻り値

型: HRESULT

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

vtbl 14 HRESULT GetDeviceModels(DWORD cchDeviceModels, LPWSTR wzDeviceModels, DWORD* pcchActual)

メタデータハンドラーをサポートするデバイスモデルを取得します。

cchDeviceModelsDWORDinwzDeviceModels バッファーの長さ。
wzDeviceModelsLPWSTRinoutメタデータハンドラーがサポートするデバイスモデルを受け取るポインター。
pcchActualDWORD*outデバイスモデルを取得するために必要な実際の長さ。

戻り値

型: HRESULT

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

vtbl 15 HRESULT DoesRequireFullStream(BOOL* pfRequiresFullStream)

ハンドラーが完全なストリームを必要とするかどうかを判定します。

pfRequiresFullStreamBOOL*out完全なストリームが必要な場合は TRUE を、それ以外の場合は FALSE を受け取るポインター。

戻り値

型: HRESULT

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

vtbl 16 HRESULT DoesSupportPadding(BOOL* pfSupportsPadding)

メタデータハンドラーがパディングをサポートするかどうかを判定します。

pfSupportsPaddingBOOL*outパディングがサポートされている場合は TRUE を、それ以外の場合は FALSE を受け取るポインター。

戻り値

型: HRESULT

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

vtbl 17 HRESULT DoesRequireFixedSize(BOOL* pfFixedSize)

メタデータハンドラーが固定サイズを必要とするかどうかを判定します。

pfFixedSizeBOOL*out固定サイズが必要な場合は TRUE を、それ以外の場合は FALSE を受け取るポインター。

戻り値

型: 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_IWICMetadataHandlerInfo "{ABA958BF-C672-44D1-8D61-CE6DF2E682C2}"
#usecom global IWICMetadataHandlerInfo IID_IWICMetadataHandlerInfo "{}"
#comfunc global IWICMetadataHandlerInfo_GetMetadataFormat      11 var
#comfunc global IWICMetadataHandlerInfo_GetContainerFormats    12 int,var,var
#comfunc global IWICMetadataHandlerInfo_GetDeviceManufacturer  13 int,var,var
#comfunc global IWICMetadataHandlerInfo_GetDeviceModels        14 int,var,var
#comfunc global IWICMetadataHandlerInfo_DoesRequireFullStream  15 var
#comfunc global IWICMetadataHandlerInfo_DoesSupportPadding     16 var
#comfunc global IWICMetadataHandlerInfo_DoesRequireFixedSize   17 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。