| Microsoft DirectX 8.1 (Visual Basic) |
The DMUS_NOTIFICATION_PMSG type contains information about a notification message sent by the performance.
Syntax
Type DMUS_NOTIFICATION_PMSG
ctTime As Long
lField1 As Long
lField2 As Long
lNotificationOption As Long
lNotificationType As Long
mtTime As Long
User As Unknown
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.
The possible values in this member dpend on the notification type, as shown in the following tables.
If the notification type is DMUS_NOTIFY_ON_SEGMENT, this member can contain one of the following values:
| Value | Description |
| DMUS_NOTIFICATION_SEGABORT | The segment was stopped prematurely or was removed from the primary segment queue. |
| 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:
| Value | Description |
| 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:
| Value | Description |
| DMUS_NOTIFICATION_MUSICALMOSTEND | The currently playing primary segment has reached the end minus the prepare time, and no more primary segments are cued to play. |
| 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.
If the notification type is DMUS_NOTIFY_ON_RECOMPOSE, this member contains DMUS_NOTIFICATION_RECOMPOSE. 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.
User
Object associated with the event. See Remarks.
Remarks
For most notifications, the User member contains a DirectMusicSegmentState8 object. When an application is notified of a segment event, the relevant segment can be retrieved from this object by using DirectMusicSegmentState8.GetSegment.
For notifications of type GUID_NOTIFICATION_PERFORMANCE, the User member is always Nothing.
See Also