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

IWMPMediaCollection

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID8363bc22-b4b4-4b19-989d-1cd765749dd1継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 12

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT add(LPWSTR bstrURL, IWMPMedia** ppItem)
bstrURLLPWSTRinメディアライブラリに追加するファイルの URL またはパス。
ppItemIWMPMedia**out追加されたメディアを表す IWMPMedia を受け取る。解放が必要。
vtbl 8 HRESULT getAll(IWMPPlaylist** ppMediaItems)
ppMediaItemsIWMPPlaylist**outライブラリ内の全メディアを含むプレイリストを受け取る。解放が必要。
vtbl 9 HRESULT getByName(LPWSTR bstrName, IWMPPlaylist** ppMediaItems)
bstrNameLPWSTRin検索対象のメディア名を指定する文字列。
ppMediaItemsIWMPPlaylist**out名前が一致するメディアのプレイリストを受け取る。解放が必要。
vtbl 10 HRESULT getByGenre(LPWSTR bstrGenre, IWMPPlaylist** ppMediaItems)
bstrGenreLPWSTRin検索対象のジャンル名を指定する文字列。
ppMediaItemsIWMPPlaylist**outジャンルが一致するメディアのプレイリストを受け取る。解放が必要。
vtbl 11 HRESULT getByAuthor(LPWSTR bstrAuthor, IWMPPlaylist** ppMediaItems)
bstrAuthorLPWSTRin検索対象のアーティストまたは作成者名を指定する。
ppMediaItemsIWMPPlaylist**out作成者が一致するメディアのプレイリストを受け取る。解放が必要。
vtbl 12 HRESULT getByAlbum(LPWSTR bstrAlbum, IWMPPlaylist** ppMediaItems)
bstrAlbumLPWSTRin検索対象のアルバム名を指定する文字列。
ppMediaItemsIWMPPlaylist**outアルバムが一致するメディアのプレイリストを受け取る。解放が必要。
vtbl 13 HRESULT getByAttribute(LPWSTR bstrAttribute, LPWSTR bstrValue, IWMPPlaylist** ppMediaItems)
bstrAttributeLPWSTRin検索に使う属性名を指定する文字列。
bstrValueLPWSTRin属性に一致させる値を指定する文字列。
ppMediaItemsIWMPPlaylist**out条件に一致するメディアのプレイリストを受け取る。解放が必要。
vtbl 14 HRESULT remove(IWMPMedia* pItem, VARIANT_BOOL varfDeleteFile)
pItemIWMPMedia*inライブラリから削除するメディア項目の IWMPMedia。
varfDeleteFileVARIANT_BOOLin実ファイルも削除するかを指定する。VARIANT_TRUE で物理削除。
vtbl 15 HRESULT getAttributeStringCollection(LPWSTR bstrAttribute, LPWSTR bstrMediaType, IWMPStringCollection** ppStringCollection)
bstrAttributeLPWSTRin値の一覧を取得する属性名を指定する。
bstrMediaTypeLPWSTRin対象メディア種別を指定する。audio や video など。
ppStringCollectionIWMPStringCollection**out属性値の一覧を表す IWMPStringCollection を受け取る。解放が必要。
vtbl 16 HRESULT getMediaAtom(LPWSTR bstrItemName, INT* plAtom)
bstrItemNameLPWSTRinアトム値を取得する属性名を指定する文字列。
plAtomINT*inout属性に対応する数値アトム識別子を受け取る。
vtbl 17 HRESULT setDeleted(IWMPMedia* pItem, VARIANT_BOOL varfIsDeleted)
pItemIWMPMedia*in削除済みフラグを変更するメディア項目の IWMPMedia。
varfIsDeletedVARIANT_BOOLin削除済み状態にするかを指定する。VARIANT_TRUE で削除済み。
vtbl 18 HRESULT isDeleted(IWMPMedia* pItem, VARIANT_BOOL* pvarfIsDeleted)
pItemIWMPMedia*in状態を確認するメディア項目の IWMPMedia。
pvarfIsDeletedVARIANT_BOOL*inout項目が削除済みかを受け取る。VARIANT_TRUE で削除済み。

HSP用 COM定義

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

出力引数: 
#define global IID_IWMPMediaCollection "{8363BC22-B4B4-4B19-989D-1CD765749DD1}"
#usecom global IWMPMediaCollection IID_IWMPMediaCollection "{}"
#comfunc global IWMPMediaCollection_add                           7 wstr,sptr
#comfunc global IWMPMediaCollection_getAll                        8 sptr
#comfunc global IWMPMediaCollection_getByName                     9 wstr,sptr
#comfunc global IWMPMediaCollection_getByGenre                    10 wstr,sptr
#comfunc global IWMPMediaCollection_getByAuthor                   11 wstr,sptr
#comfunc global IWMPMediaCollection_getByAlbum                    12 wstr,sptr
#comfunc global IWMPMediaCollection_getByAttribute                13 wstr,wstr,sptr
#comfunc global IWMPMediaCollection_remove                        14 sptr,int
#comfunc global IWMPMediaCollection_getAttributeStringCollection  15 wstr,wstr,sptr
#comfunc global IWMPMediaCollection_getMediaAtom                  16 wstr,var
#comfunc global IWMPMediaCollection_setDeleted                    17 sptr,int
#comfunc global IWMPMediaCollection_isDeleted                     18 sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。