Microsoft DirectX 9.0

DMUS_WAVE_PMSG

The DMUS_WAVE_PMSG structure contains message data for a wave sound.

Syntax

typedef struct _DMUS_WAVE_PMSG {
  DMUS_PMSG_PART
  REFERENCE_TIME rtStartOffset;
  REFERENCE_TIME rtDuration;
  long  lOffset;
  long  lVolume;
  long  lPitch;
  BYTE  bFlags;
} DMUS_WAVE_PMSG;
;

Members

DMUS_PMSG_PART

Macro for common message members. See DMUS_PMSG. The punkUser member contains the address of the IUnknown interface of the voice object associated with the wave.

rtStartOffset

How far into the wave to start, in reference time units only.

rtDuration

Duration of the wave. If DMUS_PMSGF_LOCKTOREFTIME is present in the dwFlags member of DMUS_PMSG_PART, this value is in reference time units. Otherwise it is in music time.

lOffset

Offset from actual time to logical time, in either reference or music time.

lVolume

Initial volume, in hundredths of a decibel.

lPitch

Transposition of the pitch, in hundredths of a semitone.

bFlags

Can be zero or one of the following values.

Value	Description
DMUS_WAVEF_IGNORELOOPS	Wave is not invalidated when a segment loop point is reached.
DMUS_WAVEF_NOINVALIDATE	Wave is not invalidated.
DMUS_WAVEF_OFF	This message is stopping playback of the wave.
DMUS_WAVEF_STREAMING	Wave is streaming.

Remarks

Applications cannot send messages of this type by using IDirectMusicPerformance8::SendPMsg, because they have no way of obtaining a pointer to a wave object. However, tools can process wave messages.

Requirements

Header: Declared in dmusici.h.