IWMDMStorage4::SetReferences メソッド (mswmdm.h)

[アーティクル]
02/29/2024

SetReferences メソッドは、参照 (プレイリストやアルバムなど) を含むストレージに含まれる参照を設定し、ストレージが保持していた既存の参照をすべて上書きします。

構文

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IWMDMStorage **ppIWMDMStorage
);

パラメーター

[in] dwRefs

ppIWMDMStorage 内の IWMDMStorage インターフェイスポインターの数。ゼロは許容される値であり、ストレージからのすべての参照をクリアします。この場合、ストレージ自体は削除されません。

[in] ppIWMDMStorage

ストレージによって参照される IWMDMStorage インターフェイスポインターの配列へのポインター。この順序はストレージによって保持されます。 dwRefs も 0 の場合、NULL は許容される値です。呼び出し元は、この配列の割り当てと解放を担当します。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

このメソッドは、プレイリストやアルバムなどの参照で構成されるオブジェクトの参照を設定するために使用されます。デバイスがメタデータをサポートしていない場合、このメソッドはおそらくサポートされません。

有効な IWMDMStorage オブジェクトは 、ppIWMDMStorage 配列に含めることができます。これには、参照自体を指定するフォルダーやその他のストレージ (プレイリストのプレイリストの作成など) が含まれます。デバイス自体は、参照先オブジェクトの特定のケースの処理方法を決定します。 Windows Media デバイスマネージャーでは、IWMDMStorage の有効性を超える規則は適用されません。入れ子になったプレイリスト参照を含むプレイリストのケースを考えてみましょう。 1 つのデバイスでは、これは許可されておらず、 SetReferences は 失敗します。別のデバイスでは、これは許可されます。再生は、含まれている参照のセット全体を深さ優先順に走査するだけです。

この状況は、 IWMDMStorage4 インターフェイスポインターが、デバイスに存在しなくなったストレージに対応している場合に発生する可能性があります。この場合、WMDM_E_INTERFACEDEADが返されます。