Platform SDK: DirectX

IDirectMusicLoader::CacheObject

IDirectMusicLoader::CacheObject メソッドは、オブジェクトへの参照を維持するようローダーに指示する。この結果、オブジェクトを 2 回ロードしないことが保証される。

HRESULT CacheObject(
  IDirectMusicObject * pObject
);

パラメータ

pObject
キャッシュに入れるオブジェクトの IDirectMusicObject インターフェイスのアドレス。

戻り値

成功すれば S_OK を返す。オブジェクトが既にキャッシュに入っている場合は S_FALSE を返す。

失敗すれば次のエラー値のいずれかを返す。

E_POINTER
DMUS_E_LOADER_OBJECTNOTFOUND

注意

アプリケーションの実行期間中、複数の場所からアクセスされるオブジェクトが存在する場合、ローダーにそのオブジェクトをキャッシングさせるとパフォーマンスが大幅に高速化される。概要については、「オブジェクトのキャッシング」を参照すること。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicLoader::EnableCacheIDirectMusicLoader::ClearCacheIDirectMusicLoader::ReleaseObject