Microsoft DirectX 8.1 (C++)

IDirectMusicAudioPath8::Activate

The Activate method activates or deactivates the audiopath.

Syntax

HRESULT Activate(
  BOOL fActivate
);

Parameters

fActivate

Boolean that specifies whether to activate (TRUE) or deactivate (FALSE) the path.

Return Values

If the method succeeds, the return value is S_OK, or S_FALSE if the audiopath is already in the requested state.

Remarks

The behavior of this method is different from that of IDirectMusicPort8::Activate. When a port is deactivated, it no longer produces sound, but the performance can continue playing segments. When an audiopath is deactivated, all playback stops and any attempt to play a segment will fail.

Requirements

  Header: Declared in dmusici.h.

See Also