ホーム › Media.MediaPlayer › IWMPPlayerServices

IWMPPlayerServices

COM

IID1d01fbdb-ade2-4c8d-9842-c190b95c3306継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMPPlayerServices インターフェイスは、リモート化された Windows Media Player コントロールのホストが、プレーヤーのフルモードを操作するために使用するメソッドを提供します。これらのメソッドは C++ でのみ使用できます。

メソッド 3

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

vtbl 3 HRESULT activateUIPlugin(LPWSTR bstrPlugin)

activateUIPlugin メソッドは、Windows Media Player のフルモードで、指定した UI プラグインをアクティブにします。

bstrPlugin

LPWSTR

アクティブにするプラグインの名前を格納した BSTR。

戻り値

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

値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

このメソッドは、Windows Media Player コントロールをリモート化する場合にのみ使用します。

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

vtbl 4 HRESULT setTaskPane(LPWSTR bstrTaskPane)

setTaskPane メソッドは、Windows Media Player のフルモードで、指定したタスクペインを表示します。

bstrTaskPane

LPWSTR

次のいずれかの値を格納した BSTR。

値	説明
NowPlaying	Windows Media Player 9、10、11: Windows Media Player を Now Playing 機能で開きます。 Windows Media Player 12: Windows Media Player を Player モードで開きます。
MediaGuide	Windows Media Player 9、10、11: Windows Media Player を Media Guide 機能で開きます。 Windows Media Player 12: Media Guide を表示した状態で、Windows Media Player を Library モードで開きます。
CopyFromCD	Windows Media Player 9: Windows Media Player を Copy From CD 機能で開きます。 Windows Media Player 10、11: Windows Media Player を Rip 機能で開きます。 Windows Media Player 12: Windows Media Player を Library モードで開きます。
CopyFromCD?AutoCopy:id	Windows Media Player 9: Windows Media Player を Copy From CD 機能で開き、切り替え後に自動的にコピー機能を呼び出します。 Windows Media Player 10、11: Windows Media Player を Rip 機能で開き、切り替え後に自動的にリップ機能を呼び出します。 Windows Media Player 12: Windows Media Player を Library モードで開き、切り替え後に自動的にリップ機能を呼び出します。すべてのバージョン: 特定のドライブ識別子を指定するには、コロン文字 (:) に続けて CD ドライブの識別子番号を付加します。コロンと ID を省略した場合は、最初の CD ドライブが使用されます。ユーザーが Windows Media Player で Eject CD when copying is completed を選択している場合、コピーの完了時に CD が取り出されます。
Library	Windows Media Player 9、10、11: Windows Media Player を Library 機能で開きます。 Windows Media Player 12: Play タブを開いた状態で、Windows Media Player を Library モードで開きます。
RadioTuner	Windows Media Player 9: Windows Media Player を Radio Tuner 機能で開きます。 Windows Media Player 10、11、12: 現在アクティブなオンラインストアで Windows Media Player を開きます。
CopyToCD	Windows Media Player 9: サポートされていません。 Windows Media Player 10、11: Windows Media Player を Burn 機能で開きます。 Windows Media Player 12: 書き込みリストを開いた状態で、Windows Media Player を Library モードで開きます。
CopyToCDOrDevice	Windows Media Player 9: Windows Media Player を Copy to CD or Device 機能で開きます。 Windows Media Player 10、11: Windows Media Player を Sync 機能で開きます。 Windows Media Player 12: Sync タブを開いた状態で、Windows Media Player を Library モードで開きます。
Services	Windows Media Player 9: Windows Media Player を Premium Services 機能で開きます。 Windows Media Player 10、11、12: 現在アクティブなオンラインストアで Windows Media Player を開きます。
SkinChooser	Windows Media Player を Skin Chooser 機能で開きます。

戻り値

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

値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

このメソッドは、Windows Media Player コントロールをリモート化する場合にのみ使用します。

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

vtbl 5 HRESULT setTaskPaneURL(LPWSTR bstrTaskPane, LPWSTR bstrURL, LPWSTR bstrFriendlyName)

このページでは、Windows Media Player 9 Series SDK および Windows Media Player 10 SDK の機能について説明します。以降のバージョンでは利用できない場合があります。

bstrTaskPane

LPWSTR

次のいずれかの値を格納した BSTR。

値	説明
MediaGuide	Windows Media Player を MediaGuide 機能で開きます。
RadioTuner	Windows Media Player を RadioTuner 機能で開きます。
Services	Windows Media Player を Premium Services 機能で開きます。

bstrURL

LPWSTR

タスクペインに表示する URL を格納した BSTR。

bstrFriendlyName

LPWSTR

指定した URL のコンテンツのフレンドリ名を格納した BSTR。

戻り値

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

値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

このメソッドは、Windows Media Player コントロールをリモート化する場合にのみ使用します。このメソッドは、コントロールがドッキング状態のときに呼び出す必要があります。設定すると、リモート化されたコントロールが次に Windows Media Player に遷移したときに、指定したタスクペインが開きます。

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_IWMPPlayerServices "{1D01FBDB-ADE2-4C8D-9842-C190B95C3306}"
#usecom global IWMPPlayerServices IID_IWMPPlayerServices "{}"
#comfunc global IWMPPlayerServices_activateUIPlugin  3 wstr
#comfunc global IWMPPlayerServices_setTaskPane       4 wstr
#comfunc global IWMPPlayerServices_setTaskPaneURL    5 wstr,wstr,wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。