IDirectMusicPerformance::SetGraph

The IDirectMusicPerformance::SetGraph method replaces the performance's tool graph.

HRESULT SetGraph(
  IDirectMusicGraph* pGraph
);

Parameters

pGraph

Tool graph to be set. Can be set to NULL to clear the graph from the performance.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return E_POINTER.

Remarks

Any messages flowing through tools in the current tool graph are deleted.

The graph's reference count is incremented by this method, so it is safe to release the original reference.

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

IDirectMusicSegment::SetGraph, IDirectMusicPerformance::GetGraph, IDirectMusicPerformance::SendPMsg