| Microsoft DirectX 9.0 SDK Update (October 2004) |
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: Dmusici.h
See Also