DMUS_TIMESIG_PMSG

This structure contains data for a message that controls the time signature of the performance.

typedef struct _DMUS_TIMESIG_PMSG {
  DMUS_PMSG_PART
  BYTE bBeatsPerMeasure;
  BYTE bBeat;
  WORD wGridsPerBeat;
} DMUS_TIMESIG_PMSG;

Members

  • DMUS_PMSG_PART
    Macro for common message members. For more information, see DMUS_PMSG.
  • bBeatsPerMeasure
    Beats per measure (top of the time signature).
  • bBeat
    Note that receives the beat (bottom of the time signature), where 1 is a whole note, 2 is a half note, 4 is a quarter note, and so on. Zero is a 256th note.
  • wGridsPerBeat
    Grids (subdivisions) per beat. This value determines the timing resolution for certain music events — for example, segments cued with the DMUS_SEGF_GRID flag. For more information, see DMUS_SEGF_FLAGS.

Remarks

Time-signature messages are generated by the time-signature track and the style track. In general, a segment contains one or the other, but not both. A segment representing a MIDI file has a time-signature track, but most segments authored with a tool such as DirectMusic Producer contain time-signature information in the style track.

By default, only the primary segment sends time-signature messages. For information about how to change this behavior, see Disabling and Enabling Messages.

The time signature is used by the performance to resolve time to measure, beat, and grid boundaries in all methods in which the time can be adjusted by DMUS_SEGF_FLAGS or DMUS_TIME_RESOLVE_FLAGS. The time-signature and style tracks also use the time signature to generate notifications on measure and beat boundaries. For more information, see DMUS_NOTIFICATION_PMSG.

Requirements

OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.

See Also

IDirectMusicPerformance::SendPMsg | DMUS_NOTIFICATION_PMSG | DMUS_PMSG | DMUS_TIMESIGNATURE

 Last updated on Monday, April 12, 2004

© 1992-2002 Microsoft Corporation. All rights reserved.