Microsoft DirectX 8.0 (C++)

IDirectMusicLoader8::CacheObject

Tells the loader to keep a reference to the object. This guarantees that the object is not loaded twice.

HRESULT CacheObject(
  IDirectMusicObject * pObject
);

Parameters

pObject
Address of the IDirectMusicObject interface of the object to cache. Use QueryInterface to obtain IDirectMusicObject8.

Return Values

If the method succeeds, the return value is S_OK, or S_FALSE if the object is already cached.

If it fails, the method can return one of the following error values:

E_POINTER
DMUS_E_LOADER_OBJECTNOTFOUND

Requirements

  Header: Declared in dmusici.h.

See Also

IDirectMusicLoader8::EnableCache, IDirectMusicLoader8::ClearCache, IDirectMusicLoader8::ReleaseObject, Cache Management