IDirectMusicLoader8::ReleaseObject

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

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


© 2004 Microsoft Corporation. All rights reserved.