IDirectMusicLoader8::ReleaseObject

^{IDirectMusicLoader8::ReleaseObject}

The ReleaseObject method releases the loader's reference to an object.

Syntax

HRESULT ReleaseObject(
  IDirectMusicObject * pObject
);

Parameters

pObject

IDirectMusicObject8 interface pointer of the object to release.

Return Values

If the method succeeds, the return value is S_OK, or S_FALSE if the object has already been released or cannot be found in the cache.

If it fails, the method can return E_POINTER.

Remarks

ReleaseObject is the reciprocal of IDirectMusicLoader8::CacheObject.

Objects can be cached explicitly by using the CacheObject method, or automatically by using the IDirectMusicLoader8::EnableCache method.

To tell the loader to flush all objects of a particular type, call the IDirectMusicLoader8::ClearCache method.

Requirements

  Header: Declared in dmusici.h.

See Also

• Cache Management
• IDirectMusicLoader8 Interface
• IDirectMusicLoader8::GetObject
• IDirectMusicLoader8::ReleaseObjectByUnknown