Microsoft DirectX 8.0 (C++)

IDirectMusicBand8::CreateSegment

Creates a DirectMusicSegment object that can be played in order to perform the volume, pan, transposition, and patch change commands in the band dynamically.

HRESULT CreateSegment(
  IDirectMusicSegment** ppSegment
);

Parameters

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 following error values:

E_FAIL
E_OUTOFMEMORY
E_POINTER

Remarks

For an example of creating a segment from a band, see Making Band Changes Programmatically.

Requirements

  Header: Declared in dmusici.h.