Microsoft DirectX 8.1 (C++)

IDirectMusicLoader8::CacheObject

The CacheObject method tells the loader to keep a reference to the object. This guarantees that the object is not loaded twice.

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