Microsoft DirectX 8.0 (C++)

DMUS_WAVE_PMSG

Contains message data for a wave sound.

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;
;
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 the following value.
DMUS_WAVEF_NOINVALIDATE
Do not invalidate this wave.
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.