IMDSPStorage4::SetReferences メソッド (mswmdm.h)
SetReferences メソッドは、参照 (プレイリストやアルバムなど) を含むストレージに含まれる参照を設定し、このストレージに含まれる以前に既存の参照をすべて上書きします。
構文
HRESULT SetReferences(
[in] DWORD dwRefs,
[in] IMDSPStorage **ppISPStorage
);
パラメーター
[in] dwRefs
渡された配列に含まれる IMDSPStorage インターフェイス ポインターの数。 0 は許容される値であり、ゼロ参照を含むストレージをリセットします。 この場合、ストレージ自体は削除されません。
[in] ppISPStorage
ストレージ内の参照を設定するために使用される IMDSPStorage インターフェイス ポインターの配列へのポインター。 参照の順序は、この配列内の対応する IWMDMStorage インターフェイス ポインターの順序と一致します。 dwRefs も 0 の場合、NULL は許容される値です。
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャーエラー コード
注釈
有効な IMDSPStorage オブジェクトは 、ppIMDSPStorage 配列に含まれている可能性があります。 これには、参照自体を含むフォルダーやその他のストレージ (プレイリストのプレイリストの作成など) が含まれます。
デバイスのサポートレベル (プレイリストと入れ子になったプレイリストのどちらをサポートしているか) に応じて、サービス プロバイダーはこの方法を適切に処理する必要があります。 渡された参照配列に必要なサポートレベルがデバイスにない場合、サービス プロバイダーはWMDM_E_NOTSUPPORTEDを返す必要があります。
参照に削除されたストレージが含まれている場合は、WMDM_E_INTERFACEDEADを返す必要があります。
SetReferences メソッドは、ワイプアンドロード モデルに従います。 渡される参照には完全なセットが含まれており、ストレージ オブジェクト上の既存の参照をすべて完全に置き換える必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | mswmdm.h |
| Library | Mssachlp.lib |