ホーム › Media.MediaPlayer › IWMPSyncServices

IWMPSyncServices

COM

IID8b5050ff-e0a4-4808-b3a8-893a9e1ed894継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMPSyncServices インターフェイスは、Windows Media Player 10 以降とデジタルメディアファイルを同期できる利用可能なデバイスを列挙するためのメソッドを提供します。このインターフェイスを使用するには、Windows Media Player コントロールのリモートインスタンスを作成する必要があります。

メソッド 2

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

vtbl 3 HRESULT get_deviceCount(INT* plCount)

get_deviceCount メソッドは、利用可能なデバイスの数を取得します。

plCount

INT*

inout

デバイス数を格納する long へのポインター。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
NS_E_PDA_INITIALIZINGDEVICES (0xC00D118D)	Windows Media Player は現在デバイスの初期化中でビジー状態です。後でもう一度お試しください。

解説(Remarks)

このメソッドは、以前に接続されたことはあるが、パートナーシップが確立されていないデバイスを返す場合があります。そのため、返されるデバイスの一覧は、パートナーシップを持つデバイスの一覧を表すものではありません。

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

vtbl 4 HRESULT getDevice(INT lIndex, IWMPSyncDevice** ppDevice)

getDevice メソッドは、デバイスインターフェイスへのポインターを取得します。

lIndex	INT	in	取得するデバイスのインデックスを格納する long。デバイスのインデックスは 0 から始まります。
ppDevice	IWMPSyncDevice**	out	指定されたインデックスを持つデバイスを表す IWMPSyncDevice インターフェイスへのポインターへのポインター。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
NS_E_PDA_INITIALIZINGDEVICES (0xC00D118D)	Windows Media Player は現在デバイスの初期化中でビジー状態です。後でもう一度お試しください。

解説(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_IWMPSyncServices "{8B5050FF-E0A4-4808-B3A8-893A9E1ED894}"
#usecom global IWMPSyncServices IID_IWMPSyncServices "{}"
#comfunc global IWMPSyncServices_get_deviceCount  3 var
#comfunc global IWMPSyncServices_getDevice        4 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IWMPSyncServices "{8B5050FF-E0A4-4808-B3A8-893A9E1ED894}"
#usecom global IWMPSyncServices IID_IWMPSyncServices "{}"
#comfunc global IWMPSyncServices_get_deviceCount  3 sptr
#comfunc global IWMPSyncServices_getDevice        4 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。