Win32 API 日本語リファレンス
ホームMedia.PictureAcquisition › IPhotoAcquireSource

IPhotoAcquireSource

COM
IID00f2c703-8613-4282-a53b-6ec59c5883ac継承元IUnknown自前メソッド開始 vtbl3

メソッド 8

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

vtbl 3 HRESULT GetFriendlyName(LPWSTR* pbstrFriendlyName)
pbstrFriendlyNameLPWSTR*out取得元デバイスの表示名を受け取る出力先。
vtbl 4 HRESULT GetDeviceIcons(DWORD nSize, HICON* phLargeIcon, HICON* phSmallIcon)
nSizeDWORDin要求するアイコンの基準サイズ(ピクセル)。
phLargeIconHICON*inoutoptional大アイコンのHICONを受け取る出力先。
phSmallIconHICON*inoutoptional小アイコンのHICONを受け取る出力先。
vtbl 5 HRESULT InitializeItemList(BOOL fForceEnumeration, IPhotoAcquireProgressCB* pPhotoAcquireProgressCB, DWORD* pnItemCount)
fForceEnumerationBOOLinキャッシュを無視して再列挙を強制するか否かを示すBOOL。
pPhotoAcquireProgressCBIPhotoAcquireProgressCB*inoptional列挙進捗を通知するIPhotoAcquireProgressCBポインタ。NULL可。
pnItemCountDWORD*inoutoptional列挙されたアイテム数を受け取る出力先。
vtbl 6 HRESULT GetItemCount(DWORD* pnItemCount)
pnItemCountDWORD*out取得元が持つアイテム数を受け取る出力先。
vtbl 7 HRESULT GetItemAt(DWORD nIndex, IPhotoAcquireItem** ppPhotoAcquireItem)
nIndexDWORDin取得するアイテムの0始まりインデックス。
ppPhotoAcquireItemIPhotoAcquireItem**out指定アイテムのIPhotoAcquireItemを受け取る出力先。
vtbl 8 HRESULT GetPhotoAcquireSettings(IPhotoAcquireSettings** ppPhotoAcquireSettings)
ppPhotoAcquireSettingsIPhotoAcquireSettings**out取得元に関連する設定オブジェクトIPhotoAcquireSettingsを受け取る出力先。
vtbl 9 HRESULT GetDeviceId(LPWSTR* pbstrDeviceId)
pbstrDeviceIdLPWSTR*out取得元デバイスを一意に識別するデバイスIDを受け取る出力先。
vtbl 10 HRESULT BindToObject(GUID* riid, void** ppv)
riidGUID*inバインドして取得するインターフェイスのIID。
ppvvoid**out取得したインターフェイスポインタを受け取る出力先。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IPhotoAcquireSource "{00F2C703-8613-4282-A53B-6EC59C5883AC}"
#usecom global IPhotoAcquireSource IID_IPhotoAcquireSource "{}"
#comfunc global IPhotoAcquireSource_GetFriendlyName          3 var
#comfunc global IPhotoAcquireSource_GetDeviceIcons           4 int,sptr,sptr
#comfunc global IPhotoAcquireSource_InitializeItemList       5 int,sptr,var
#comfunc global IPhotoAcquireSource_GetItemCount             6 var
#comfunc global IPhotoAcquireSource_GetItemAt                7 int,sptr
#comfunc global IPhotoAcquireSource_GetPhotoAcquireSettings  8 sptr
#comfunc global IPhotoAcquireSource_GetDeviceId              9 var
#comfunc global IPhotoAcquireSource_BindToObject             10 var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。