Microsoft DirectX 8.1 (C++)

IDirectMusicPerformance8::RemovePort

The RemovePort method removes a port from the performance. Any performance channels that map to this port are invalidated, and messages stamped with them do not play.

Syntax

HRESULT RemovePort(
  IDirectMusicPort* pPort
);

Parameters

pPort

Port to remove.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the error values shown in the following table.

Return code
E_INVALIDARG
E_POINTER

Remarks

A port added by passing NULL to IDirectMusicPerformance8::AddPort cannot be removed by passing NULL to RemovePort.

This method should not be called by applications that use audiopaths.

Requirements

  Header: Declared in dmusici.h.

See Also