Microsoft DirectX 9.0

IDirectMusicLoader8::CacheObject

The CacheObject method stores a reference to an object for later use, so that the object is not loaded more than once.

Syntax

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 error values shown in the following table.

Return code
E_POINTER
DMUS_E_LOADER_OBJECTNOTFOUND

Requirements

  Header: Declared in dmusici.h.

See Also