Win32 API 日本語リファレンス
ホーム › Media.MediaPlayer › IWMPSyncDevice2

IWMPSyncDevice2

COM
📘 Microsoft Learn (日本語) · English
IID88afb4b2-140a-44d2-91e6-4543da467cd1継承元IWMPSyncDevice自前メソッド開始 vtbl19

公式ドキュメント

IWMPSyncDevice2 インターフェイスは、IWMPSyncDevice インターフェイスを補完するメソッドを提供します。このインターフェイスを使用するには、Windows Media Player 10 以降のコントロールのリモートインスタンスを作成する必要があります。

メソッド 1

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

vtbl 19 HRESULT setItemInfo(LPWSTR bstrItemName, LPWSTR bstrVal)

setItemInfo メソッドは、デバイスの属性値を指定します。

bstrItemNameLPWSTRin新しい値を設定する属性の名前を指定する BSTR です。サポートされる属性名については、「解説」を参照してください。
bstrValLPWSTRin新しい値を指定する BSTR です。サポートされる値については、「解説」を参照してください。

戻り値

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

リターンコード 説明
S_OK
 メソッドが成功したか、パートナーシップが存在します。

解説(Remarks)

次の表に、サポートされる属性を示します。

属性 説明
AutoSyncDefaultRules 自動同期を既定のルールに従って行うか、カスタムルールに従って行うかを指定します。値 "true" は既定のルールを、値 "false" はカスタムルールを指定します。

この属性は、Windows Media Player がパートナーシップを持つデバイスに対してのみ使用できます。

Windows Media Player 12 が必要です。
BackgroundSyncState Windows Media Player がデバイスに対してバックグラウンド操作を実行できるかどうかを指定します。

値は、次のフラグの 1 つ以上をビットごとに組み合わせたものを表す文字列 (BSTR) にできます。

  • 1 バックグラウンド同期を許可します。
  • 2 バックグラウンドでのトランスコードを許可します。
値には、次の文字列のいずれかを指定することもできます。
  • "0" バックグラウンド操作を許可しません。
  • "255" すべてのバックグラウンド操作を許可します。
この属性の値は Windows Media Player の実行中は保持されますが、Windows Media Player ライブラリには保存されません。

この属性は、Windows Media Player がパートナーシップを持つデバイスに対してのみ使用できます。

Windows Media Player 12 が必要です。
IncludeSkippedFiles ユーザーがデバイスからファイルを削除すると、Windows Media Player はそれらのファイルをスキップ済みとしてマークし、以降の同期操作に含めません。この属性を設定すると、Windows Media Player は次回の同期でスキップ済みのファイルを含めるようになります。

この属性の値には空の BSTR を設定します。

この属性は、Windows Media Player がパートナーシップを持つデバイスに対してのみ使用できます。

Windows Media Player 12 が必要です。
PercentSpaceReserved ストレージの一部を予約済みとして指定することで、Windows Media Player がファイル同期に使用するデバイスストレージの容量を制限します。値は、デバイスの総ストレージに対する数値のパーセンテージを文字列 (BSTR) で表したものです。サポートされる値は "0" から "95" までです。

この属性は、Windows Media Player がパートナーシップを持つデバイスに対してのみ使用できます。
SyncFilter 次回の同期セッション中に同期されるファイルの種類を指定し、その同期セッション中にデバイスからコンテンツを取得できるかどうかを指定します。

値は、次のフラグの 1 つ以上をビットごとに組み合わせたものを表す文字列 (BSTR) にできます。

  • 1 音楽ファイルを同期します。
  • 2 ビデオファイルを同期します。
  • 4 画像ファイルを同期します。
  • 8 コンテンツをデバイスに書き込むことはできますが、デバイスから取得することはできません。
たとえば、文字列 "5" は音楽ファイルと画像ファイルが同期されることを指定します。

値には、次の文字列のいずれかを指定することもできます。

  • "0xFF" 同期セッションにフィルターを適用しません。つまり、すべての種類のファイルを同期し、コンテンツのデバイスへの書き込みとデバイスからの取得の両方を許可します。
  • "0x07" すべての種類のファイルを同期します。
この属性は次回の同期セッションにのみ影響します。

この属性は、Windows Media Player がパートナーシップを持つデバイスに対してのみ使用できます。

Windows Media Player 12 が必要です。
SyncOnConnect デバイスが接続されたときに Windows Media Player がそのデバイスを同期するかどうかを指定します。値 "true" は Windows Media Player がデバイスを同期することを、値 "false" は Windows Media Player がデバイスを同期しないことを指定します。

この属性は、Windows Media Player がパートナーシップを持つデバイスに対してのみ使用できます。

Windows Media Player 12 が必要です。

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_IWMPSyncDevice2 "{88AFB4B2-140A-44D2-91E6-4543DA467CD1}"
#usecom global IWMPSyncDevice2 IID_IWMPSyncDevice2 "{}"
#comfunc global IWMPSyncDevice2_setItemInfo  19 wstr,wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。