DMUS_IO_WAVE_ITEM_HEADER

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

DMUS_IO_WAVE_ITEM_HEADER

The DMUS_IO_WAVE_ITEM_HEADER structure contains data for a wave sound in a Wave Track List.

Syntax

typedef struct _DMUS_IO_WAVE_ITEM_HEADER {
  long     lVolume;
  long     lPitch;
  DWORD    dwVariations;
  REFERENCE_TIME rtTime;
  REFERENCE_TIME rtStartOffset; 
  REFERENCE_TIME rtReserved;
  REFERENCE_TIME rtDuration;
  MUSIC_TIME   mtLogicalTime;
  DWORD    dwLoopStart;
  DWORD    dwLoopEnd;
  DWORD    dwFlags;
  WORD     wVolumeRange;
  WORD     wPitchRange;
} DMUS_IO_WAVE_ITEM_HEADER;

Members

lVolume

Gain, in hundredths of a decibel. Must be a negative value.

lPitch

Pitch offset, in hundredths of a semitone.

dwVariations

Variation flags. One bit is set for each variation this wave belongs to.

rtTime

Start time, in reference time if the track is in clock time format; otherwise in music time.

rtStartOffset

Distance into wave to start playback, in reference time.

rtReserved

Not used.

rtDuration

Duration, in reference time if the track is in clock time format; otherwise in music time.

mtLogicalTime

Musical boundary where this belongs. Ignored if the track is in clock time format.

dwLoopStart

Start point for a looping wave.

dwLoopEnd

End point for a looping wave.

dwFlags

Flags. Can be 0 or one of the values in the following table.

Value Description
DMUS_WAVEF_IGNORELOOPS Wave is not invalidated when a segment loop point is reached.
DMUS_WAVEF_NOINVALIDATE This wave is not to be invalidated.
DMUS_WAVEF_STREAMING Wave is streaming.

wVolumeRange

Amount by which volume can be randomized, in hundredths of a decibel.

wPitchRange

Amount by which pitch can be randomized, in hundredths of a semitone.

Requirements

  Header: Declared in dmusicf.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.