Win32 API 日本語リファレンス
ホーム › UI.Xaml.Diagnostics › IBitmapData

IBitmapData

COM
📘 Microsoft Learn (日本語) · English
IIDd1a34ef2-cad8-4635-a3d2-fcda8d3f3caf継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ビジュアルツリー内のノードに関連付けられた画像を表します。

メソッド 4

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

vtbl 3 HRESULT CopyBytesTo(DWORD sourceOffsetInBytes, DWORD maxBytesToCopy, BYTE* pvBytes, DWORD* numberOfBytesCopied)

ビットマップデータ内の指定されたオフセットから、指定された最大バイト数まで呼び出し元のバッファー (pvBytes) にコピーし、コピーしたバイト数を返します。

sourceOffsetInBytesDWORDinコピーを開始するビットマップデータ内の位置 (バイト単位)。
maxBytesToCopyDWORDinコピーする最大バイト数。
pvBytesBYTE*outバイトのコピー先となるバッファー。
numberOfBytesCopiedDWORD*outコピーされたバイト数。

戻り値

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

vtbl 4 HRESULT GetStride(DWORD* pStride)

データのストライドを取得します。これはビットマップの各行のバイト単位の長さです。

pStrideDWORD*outビットマップの各行のバイト単位の長さ。

戻り値

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

vtbl 5 HRESULT GetBitmapDescription(BitmapDescription* pBitmapDescription)

IBitmapData に格納されたビットマップデータを記述する BitmapDescription を取得します。

pBitmapDescriptionBitmapDescription*outIBitmapData に格納されたビットマップに関する情報。

戻り値

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

vtbl 6 HRESULT GetSourceBitmapDescription(BitmapDescription* pBitmapDescription)

IBitmapData に格納されたビットマップデータの元の形式を記述する BitmapDescription を取得します。

pBitmapDescriptionBitmapDescription*outIBitmapData に格納されたビットマップの元の形式に関する情報。

戻り値

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

解説(Remarks)

ビットマップデータが形式変換またはスケーリングされていない限り、これは GetBitmapDescription が返す BitmapDescription と同じ値になります。形式変換とスケーリングは、IBitmapData を返したメソッドのコントラクトを満たすために必要に応じて行われます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IBitmapData "{D1A34EF2-CAD8-4635-A3D2-FCDA8D3F3CAF}"
#usecom global IBitmapData IID_IBitmapData "{}"
#comfunc global IBitmapData_CopyBytesTo                 3 int,int,var,var
#comfunc global IBitmapData_GetStride                   4 var
#comfunc global IBitmapData_GetBitmapDescription        5 var
#comfunc global IBitmapData_GetSourceBitmapDescription  6 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。