IWMPMediaCollection2
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
IWMPMediaCollection2 インターフェイスは、IWMPMediaCollection インターフェイスを補完するメソッドを提供します。
メソッド 4
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
createQuery メソッドは、新しいクエリを表す IWMPQuery インターフェイスへのポインターを取得します。
| ppQuery | IWMPQuery** | out | 新しい空のクエリへの IWMPQuery ポインターを受け取る変数のアドレス。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドが成功しました。 |
解説(Remarks)
新しいクエリの作成は、複合クエリを作成するための最初のステップです。
Windows Media Player 10 Mobile: このメソッドはサポートされていません。
getPlaylistByQuery メソッドは、IWMPPlaylist インターフェイスへのポインターを取得します。このインターフェイスは、クエリ条件に一致するメディア項目を含むプレイリストを表します。
| pQuery | IWMPQuery* | in | クエリを表す IWMPQuery インターフェイスへのポインター。 |
| bstrMediaType | LPWSTR | in | メディアの種類を含む文字列。次のいずれかの値を含む必要があります: "audio"、"video"、"photo"、"playlist"、"other"。 |
| bstrSortAttribute | LPWSTR | in | 並べ替えに使用する属性名を含む文字列。空の文字列は並べ替えを適用しないことを意味します。 |
| fSortAscending | VARIANT_BOOL | in | プレイリストを昇順で並べ替える必要があるかどうかを示す VARIANT_BOOL。 |
| ppPlaylist | IWMPPlaylist** | out | 取得したプレイリストの IWMPPlaylist インターフェイスへのポインターを受け取る変数のアドレス。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドが成功しました。 |
解説(Remarks)
IWMPQuery を使用する複合クエリでは、大文字と小文字は区別されません。
pQuery パラメーターで指定した複合クエリに MediaType 属性に基づく条件が含まれている場合、その条件は無視されます。常に bstrMediaType パラメーターの値が使用されます。たとえば、複合クエリに条件 "MediaType Equals audio" が含まれ、bstrMediaType パラメーターの値が "video" である場合、生成されるプレイリストには video 項目のみが含まれます。
Windows Media Player 10 Mobile: このメソッドはサポートされていません。
getStringCollectionByQuery メソッドは、IWMPStringCollection インターフェイスへのポインターを取得します。このインターフェイスは、指定した属性についてクエリ条件に一致するすべての文字列値のセットを表します。
| bstrAttribute | LPWSTR | in | 属性名を含む文字列。 |
| pQuery | IWMPQuery* | in | 文字列コレクションの取得に使用する条件を定義するクエリを表す IWMPQuery インターフェイスへのポインター。 |
| bstrMediaType | LPWSTR | in | メディアの種類を含む文字列。次のいずれかの値を含む必要があります: "audio"、"video"、"photo"、"playlist"、"other"。 |
| bstrSortAttribute | LPWSTR | in | 並べ替えに使用する属性名を含む文字列。空の文字列は並べ替えを適用しないことを意味します。 |
| fSortAscending | VARIANT_BOOL | in | プレイリストを昇順で並べ替える必要があるかどうかを示す VARIANT_BOOL。 |
| ppStringCollection | IWMPStringCollection** | out | 取得した文字列値のセットの IWMPStringCollection インターフェイスへのポインターを受け取る変数のアドレス。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドが成功しました。 |
解説(Remarks)
IWMPQuery を使用する複合クエリでは、大文字と小文字は区別されません。
pQuery パラメーターで指定した複合クエリに MediaType 属性に基づく条件が含まれている場合、その条件は無視されます。常に bstrMediaType パラメーターの値が使用されます。たとえば、複合クエリに条件 "MediaType Equals audio" が含まれ、bstrMediaType パラメーターの値が "video" である場合、生成されるプレイリストには video 項目のみが含まれます。
Windows Media Player 10 Mobile: このメソッドはサポートされていません。
getByAttributeAndMediaType メソッドは、IWMPPlaylist インターフェイスへのポインターを取得します。このインターフェイスは、指定した属性とメディアの種類を持つメディア項目を含むプレイリストを表します。
| bstrAttribute | LPWSTR | in | 指定する属性を含む文字列。 |
| bstrValue | LPWSTR | in | bstrAttribute で指定した属性に対して指定する値を含む文字列。 |
| bstrMediaType | LPWSTR | in | 指定するメディアの種類を含む文字列。 |
| ppMediaItems | IWMPPlaylist** | out | 取得したプレイリストの IWMPPlaylist インターフェイスへのポインターを受け取る変数のアドレス。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドが成功しました。 |
解説(Remarks)
Windows Media Player 10 Mobile: このメソッドはサポートされていません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
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 不要)。