Platform SDK: DirectX |
IDirectMusicLoader::CacheObject メソッドは、オブジェクトへの参照を維持するようローダーに指示する。この結果、オブジェクトを 2 回ロードしないことが保証される。
HRESULT CacheObject( IDirectMusicObject * pObject );
成功すれば 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::EnableCache、IDirectMusicLoader::ClearCache、IDirectMusicLoader::ReleaseObject