ホーム › Media.MediaPlayer › IWMPLibrary

IWMPLibrary

COM

📘 Microsoft Learn (日本語) · English

IID3df47861-7df1-4c1f-a81b-4c26f0f7a7c6継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMPLibrary インターフェイスはライブラリを表します。

メソッド 4

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT get_name(LPWSTR* pbstrName)

get_name メソッドは、現在のライブラリの表示名を取得します。

pbstrName

LPWSTR*

inout

現在のライブラリの名前を格納する文字列へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

リターンコード	説明
S_OK	メソッドは成功しました。

解説(Remarks)

Windows Media Player 10 Mobile: このメソッドはサポートされていません。

vtbl 4 HRESULT get_type(WMPLibraryType* pwmplt)

get_type メソッドは、ライブラリの種類を示す値を取得します。

pwmplt

WMPLibraryType*

inout

ライブラリの種類を示す WMPLibraryType 列挙体の値を受け取る変数へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

リターンコード	説明
S_OK	メソッドは成功しました。

解説(Remarks)

Windows Media Player 10 Mobile: このメソッドはサポートされていません。

vtbl 5 HRESULT get_mediaCollection(IWMPMediaCollection** ppIWMPMediaCollection)

get_mediaCollection メソッドは、現在のライブラリの IWMPMediaCollection インターフェイスへのポインターを取得します。

ppIWMPMediaCollection

IWMPMediaCollection**

out

現在のライブラリの IWMPMediaCollection インターフェイスへのポインターを受け取る変数のアドレス。

戻り値

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

リターンコード	説明
S_OK	メソッドは成功しました。

解説(Remarks)

Windows Media Player 10 Mobile: このメソッドはサポートされていません。

vtbl 6 HRESULT isIdentical(IWMPLibrary* pIWMPLibrary, VARIANT_BOOL* pvbool)

isIdentical メソッドは、指定されたオブジェクトが現在のオブジェクトと同じかどうかを示す値を取得します。

pIWMPLibrary	IWMPLibrary*	in	現在のオブジェクトと比較するオブジェクトを表す IWMPLibrary インターフェイスへのポインター。
pvbool	VARIANT_BOOL*	inout	比較の結果を受け取る VARIANT_BOOL へのポインター。VARIANT_TRUE は、オブジェクトが同じであることを示します。

戻り値

このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

リターンコード	説明
S_OK	メソッドは成功しました。

解説(Remarks)

Windows Media Player 10 Mobile: このメソッドはサポートされていません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

出力引数:

#define global IID_IWMPLibrary "{3DF47861-7DF1-4C1F-A81B-4C26F0F7A7C6}"
#usecom global IWMPLibrary IID_IWMPLibrary "{}"
#comfunc global IWMPLibrary_get_name             3 var
#comfunc global IWMPLibrary_get_type             4 var
#comfunc global IWMPLibrary_get_mediaCollection  5 sptr
#comfunc global IWMPLibrary_isIdentical          6 sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWMPLibrary "{3DF47861-7DF1-4C1F-A81B-4C26F0F7A7C6}"
#usecom global IWMPLibrary IID_IWMPLibrary "{}"
#comfunc global IWMPLibrary_get_name             3 sptr
#comfunc global IWMPLibrary_get_type             4 sptr
#comfunc global IWMPLibrary_get_mediaCollection  5 sptr
#comfunc global IWMPLibrary_isIdentical          6 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。