IWMPCore3
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
IWMPCore3 インターフェイスは、IWMPCore2 インターフェイスを補完するメソッドを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
newPlaylist メソッドは、新しいプレイリストの IWMPPlaylist インターフェイスへのポインターを取得します。
| bstrName | LPWSTR | in | プレイリスト名を格納する BSTR。 |
| bstrURL | LPWSTR | in | プレイリストの URL を格納する BSTR。 |
| ppPlaylist | IWMPPlaylist** | out | IWMPPlaylist インターフェイスへのポインターへのポインター。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メソッドが成功しました。 |
解説(Remarks)
bstrURL パラメーターが null または空の文字列の場合、このメソッドは空の Playlist オブジェクトを作成します。bstrname パラメーターが空の文字列の場合、このメソッドは現在のメタファイル名を適用します。
このメソッドで作成された新しいプレイリストはライブラリには追加されません。新しいプレイリストをライブラリに追加するには、IWMPPlaylistCollection::importPlaylist または IWMPPlaylistCollection::newPlaylist を使用してください。プレイリスト名の先頭または末尾にある空白は、ライブラリへの追加時に自動的に削除されます。
ライブラリでは同じ名前のプレイリストを複数許可しているため、新しいプレイリストを追加する前に、指定した名前のプレイリストが既に存在するかどうかを確認するとよいでしょう。
newMedia メソッドは、新しいメディア項目の IWMPMedia インターフェイスへのポインターを取得します。
| bstrURL | LPWSTR | in | URL を格納する BSTR。 |
| ppMedia | IWMPMedia** | out | IWMPMedia インターフェイスへのポインターへのポインター。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メソッドが成功しました。 |
解説(Remarks)
bstrURL パラメーターは、空の文字列または null であってはなりません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWMPCore3 "{7587C667-628F-499F-88E7-6A6F4E888464}"
#usecom global IWMPCore3 IID_IWMPCore3 "{}"
#comfunc global IWMPCore3_newPlaylist 29 wstr,wstr,sptr
#comfunc global IWMPCore3_newMedia 30 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。