IDirectMusicPerformance::CloseDown

The IDirectMusicPerformance::CloseDown method closes down the performance object. An application that created the performance object and called IDirectMusicPerformance::Init on it must call CloseDown before the performance is released.

HRESULT CloseDown();

Parameters

None.

Return Values

The method returns S_OK.

Remarks

Failure to call CloseDown can cause memory leaks or program failures.

CloseDown handles the release of the IDirectMusic interface if the application passed NULL, or a pointer to NULL, to IDirectMusicPerformance::Init, causing a DirectMusic object to be created. In cases in which the application explicitly created the DirectMusic object and passed the pointer to Init, the application is responsible for releasing the IDirectMusic interface.

CloseDown also releases any downloaded instruments that have not been unloaded.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

IDirectMusicPerformance::Init