IDirectMusicComposer::ComposeSegmentFromShape

This method creates an original segment from a style and a chord map, based on a predefined shape. The shape represents the way chords and embellishments occur over time across the segment.

HRESULT ComposeSegmentFromShape(
  IDirectMusicStyle* pStyle,
  WORD wNumMeasures,
  WORD wShape,
  WORD wActivity,
  BOOL fIntro,
  BOOL fEnd,
  IDirectMusicChordMap* pChordMap,
  IDirectMusicSegment** ppSegment
);

Parameters

  • pStyle
    Style from which to compose the segment.
  • wNumMeasures
    Length, in measures, of the segment to be composed.
  • wShape
    Shape of the segment to be composed. Possible values are of the DMUS_SHAPET_TYPES enumerated type.
  • wActivity
    Rate of harmonic motion. Valid values are from 0 through 3. Lower values mean more chord changes.
  • fIntro
    TRUE if an introduction is to be composed for the segment.
  • fEnd
    TRUE if an ending is to be composed for the segment.
  • pChordMap
    Chord map from which to create the segment.
  • ppSegment
    Address of a variable to receive a pointer to the created segment.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return E_POINTER.

Requirements

OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.

See Also

DMUS_SHAPET_TYPES | IDirectMusicComposer::ComposeSegmentFromTemplate | IDirectMusicComposer::ComposeTemplateFromShape

 Last updated on Monday, April 12, 2004

© 1992-2002 Microsoft Corporation. All rights reserved.