Platform SDK: DirectX

DMUS_NOTIFICATION_PMSG

The DMUS_NOTIFICATION_PMSG type contains information about a notification message sent by the performance.

Type DMUS_NOTIFICATION_PMSG
    ctTime As Long
    lField1 As Long
    lField2 As Long
    lNotificationOption As Long
    lNotificationType As Long
    mtTime As Long
End Type

Members

ctTime
Time stamp of the message, in clock time.
lField1
Extra data specific to the type of notification. For DMUS_NOTIFY_ON_MEASUREANDBEAT notifications, this member returns the beat number within the measure.
lField2
Extra data specific to the type of notification. Reserved for future or application-defined use.
lNotificationOption
Identifier of the notification subtype, from the CONST_DMUS_NOTIFICATION_SUBTYPE enumeration.

If the notification type is DMUS_NOTIFY_ON_SEGMENT, this member can contain one of the following values:

DMUS_NOTIFICATION_SEGABORT
The segment was stopped by DirectMusicPerformance.Stop.
DMUS_NOTIFICATION_SEGALMOSTEND
The segment has reached the end minus the prepare time.
DMUS_NOTIFICATION_SEGEND
The segment has ended.
DMUS_NOTIFICATION_SEGLOOP
The segment has looped.
DMUS_NOTIFICATION_SEGSTART
The segment has started.

If the notification type is DMUS_NOTIFY_ON_COMMAND, this member can contain one of the following values:

DMUS_NOTIFICATION_GROOVE
Groove change.
DMUS_NOTIFICATION_EMBELLISHMENT
Embellishment command (intro, fill, break, or end).

If the notification type is DMUS_NOTIFY_ON_PERFORMANCE, this member can contain one of the following values:

DMUS_NOTIFICATION_MUSICSTARTED
Playback has started.
DMUS_NOTIFICATION_MUSICSTOPPED
Playback has stopped.

If the notification type is DMUS_NOTIFY_ON_MEASUREANDBEAT, this member contains DMUS_NOTIFICATION_MEASUREBEAT. No other subtypes are defined.

If the notification type is DMUS_NOTIFY_ON_CHORD, this member contains DMUS_NOTIFICATION_CHORD. No other subtypes are defined.

lNotificationType
Identifier of the notification type, from the CONST_DMUS_NOTIFICATION_TYPE enumeration.
mtTime
Time stamp of the message, in music time.

See Also

DirectMusicPerformance.AddNotificationType, DirectMusicPerformance.GetNotificationPMSG