IDirectMusicSegment::SetGraph

The IDirectMusicSegment::SetGraph method assigns a tool graph to the segment.

HRESULT SetGraph(
  IDirectMusicGraph* pGraph
);

Parameters

pGraph

Tool graph to be set. Can be set to NULL to clear the segment graph.

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, 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

IDirectMusicPerformance::SetGraph, DirectMusic Tools