IWMPLibraryServices
COM公式ドキュメント
IWMPLibraryServices インターフェイスは、ライブラリを列挙するためのメソッドを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
getCountByType メソッドは、指定された種類の利用可能なライブラリの数を取得します。
| wmplt | WMPLibraryType | in | 数を取得するライブラリの種類を指定する WMPLibraryType 列挙値。 |
| plCount | INT* | inout | ライブラリ数を受け取る long へのポインター。 |
戻り値
このメソッドは HRESULT を返します。指定可能な値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
WMPLibraryType 列挙の wmpltRemote 値で表されるライブラリの数を取得するには、Player コントロールがリモート モードで実行されている必要があります。Player コントロールをリモート モードで実行する方法については、「Remoting the Windows Media Player Control」を参照してください。
plCount 変数は、そのポインターを渡す前に初期化しておく必要があります。
Windows Media Player 10 Mobile: このメソッドはサポートされていません。
getLibraryByType メソッドは、指定された種類とインデックスを持つライブラリを表す IWMPLibrary インターフェイスへのポインターを取得します。
| wmplt | WMPLibraryType | in | 取得するライブラリの種類を指定する WMPLibraryType 列挙値。 |
| lIndex | INT | in | 取得するライブラリのインデックスを格納した long。 |
| ppIWMPLibrary | IWMPLibrary** | out | 取得された IWMPLibrary インターフェイスへのポインターを受け取る変数のアドレス。 |
戻り値
このメソッドは HRESULT を返します。指定可能な値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
ローカル ライブラリは 1 つだけであり、ディスク ライブラリはメディア コンテンツを含むデータ CD および DVD でのみ利用できます。
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_IWMPLibraryServices "{39C2F8D5-1CF2-4D5E-AE09-D73492CF9EAA}" #usecom global IWMPLibraryServices IID_IWMPLibraryServices "{}" #comfunc global IWMPLibraryServices_getCountByType 3 int,var #comfunc global IWMPLibraryServices_getLibraryByType 4 int,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWMPLibraryServices "{39C2F8D5-1CF2-4D5E-AE09-D73492CF9EAA}" #usecom global IWMPLibraryServices IID_IWMPLibraryServices "{}" #comfunc global IWMPLibraryServices_getCountByType 3 int,sptr #comfunc global IWMPLibraryServices_getLibraryByType 4 int,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。