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

IWMPMediaCollection2

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

メソッド 4

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

vtbl 19 HRESULT createQuery(IWMPQuery** ppQuery)
ppQueryIWMPQuery**out新しい問い合わせを構築する IWMPQuery インターフェイスを受け取る。解放が必要。
vtbl 20 HRESULT getPlaylistByQuery(IWMPQuery* pQuery, LPWSTR bstrMediaType, LPWSTR bstrSortAttribute, VARIANT_BOOL fSortAscending, IWMPPlaylist** ppPlaylist)
pQueryIWMPQuery*in検索条件を保持する IWMPQuery インターフェイス。
bstrMediaTypeLPWSTRin対象メディア種別を指定する。audio や video など。
bstrSortAttributeLPWSTRin並べ替えに使う属性名を指定する。
fSortAscendingVARIANT_BOOLin昇順で並べ替えるかを指定する。VARIANT_TRUE で昇順。
ppPlaylistIWMPPlaylist**out条件に一致した結果のプレイリスト IWMPPlaylist を受け取る。解放が必要。
vtbl 21 HRESULT getStringCollectionByQuery(LPWSTR bstrAttribute, IWMPQuery* pQuery, LPWSTR bstrMediaType, LPWSTR bstrSortAttribute, VARIANT_BOOL fSortAscending, IWMPStringCollection** ppStringCollection)
bstrAttributeLPWSTRin値を抽出する属性名を指定する。
pQueryIWMPQuery*in絞り込み条件を保持する IWMPQuery インターフェイス。
bstrMediaTypeLPWSTRin対象メディア種別を指定する。audio や video など。
bstrSortAttributeLPWSTRin並べ替えに使う属性名を指定する。
fSortAscendingVARIANT_BOOLin昇順で並べ替えるかを指定する。VARIANT_TRUE で昇順。
ppStringCollectionIWMPStringCollection**out条件に一致した属性値の一覧 IWMPStringCollection を受け取る。解放が必要。
vtbl 22 HRESULT getByAttributeAndMediaType(LPWSTR bstrAttribute, LPWSTR bstrValue, LPWSTR bstrMediaType, IWMPPlaylist** ppMediaItems)
bstrAttributeLPWSTRin検索に使う属性名を指定する。
bstrValueLPWSTRin属性に一致させる値を指定する。
bstrMediaTypeLPWSTRin対象メディア種別を指定する。audio や video など。
ppMediaItemsIWMPPlaylist**out条件に一致したメディアのプレイリストを受け取る。解放が必要。

HSP用 COM定義

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

#define global IID_IWMPMediaCollection2 "{8BA957F5-FD8C-4791-B82D-F840401EE474}"
#usecom global IWMPMediaCollection2 IID_IWMPMediaCollection2 "{}"
#comfunc global IWMPMediaCollection2_createQuery                 19 sptr
#comfunc global IWMPMediaCollection2_getPlaylistByQuery          20 sptr,wstr,wstr,int,sptr
#comfunc global IWMPMediaCollection2_getStringCollectionByQuery  21 wstr,sptr,wstr,wstr,int,sptr
#comfunc global IWMPMediaCollection2_getByAttributeAndMediaType  22 wstr,wstr,wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。