IDirectMusicBand::CreateSegment

The IDirectMusicBand::CreateSegment method creates a DirectMusicSegment object that can be used to perform the volume, pan, transposition, and patch change commands in the band dynamically using the IDirectMusicPerformance::PlaySegment method.

HRESULT CreateSegment(
  IDirectMusicSegment** ppSegment
);

Parameters

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 may 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.

QuickInfo

  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.