IDirectMusicComposer8::ComposeSegmentFromShape

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

IDirectMusicComposer8::ComposeSegmentFromShape

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

Syntax

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

Pointer to the IDirectMusicChordMap8 interface of the chordmap from which to create the segment.

ppSegment

Address of a variable that receives 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 one of the error values shown in the following table.

Return code
E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

Requirements

  Header: Declared in dmusici.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.