IWMPSubscriptionServiceCallback
COM公式ドキュメント
メモ このセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
メモ このセクションでは、オンラインストアでの使用を想定して設計された機能について説明します。この機能をオンラインストア以外のコンテキストで使用することはサポートされていません。onComplete メソッドは、バックグラウンドプロセスが完了したときに Windows Media Player に通知します。
| hrResult | HRESULT | in | HRESULT の成功コードまたはエラーコード。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には次の表の値が含まれますが、これらに限定されません。
| 戻り値コード | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
IWMPSubscriptionService2::prepareForSync および IWMPSubscriptionService2::deviceAvailable は、IWMPSubscriptionServiceCallback インターフェイスへのポインターを提供します。Windows Media Player からこれらのメソッドへの呼び出しに応答する際は、時間のかかるタスクを別のワーカースレッドに渡し、すぐに戻る必要があります。ワーカースレッドがタスクを完了したら、IWMPSubscriptionServiceCallback::onComplete を呼び出す必要があります。
prepareForSync メソッドと deviceAvailable メソッドでは、次の手順に従って、ワーカースレッドに IWMPSubscriptionServiceCallback インターフェイスへのポインターを提供します。
- pCB パラメーターで提供されたポインターを CoMarshalInterThreadInterfaceInStream に渡します。これにより IStream ポインターが返されます。
- IStream ポインターをワーカースレッドに渡します。
- ワーカースレッドで CoGetInterfaceAndReleaseStream を呼び出します。これにより、onComplete を呼び出すために使用できるインターフェイスポインターが返されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWMPSubscriptionServiceCallback "{DD01D127-2DC2-4C3A-876E-63312079F9B0}"
#usecom global IWMPSubscriptionServiceCallback IID_IWMPSubscriptionServiceCallback "{}"
#comfunc global IWMPSubscriptionServiceCallback_onComplete 3 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。