IDirectMusicPerformance

This interface is the overall manager of music playback. It is used for adding and removing ports, mapping performance channels to ports, playing segments, dispatching messages and routing them through tools, requesting and receiving event notification, and setting and retrieving music parameters. It also has several methods for getting information about timing and for converting time and music values from one system to another.

If an application needs two complete sets of music playing at the same time, it can do so by creating more than one performance. Separate performances obey separate tempo maps, and so play completely asynchronously, whereas all segments within one performance play in lock step.

The methods of the IDirectMusicPerformance interface can be organized into the following groups:

Channels AssignPChannel
  AssignPChannelBlock
  PChannelInfo
Instruments DownloadInstrument
Messages AllocPMsg
  FreePMsg
  SendPMsg
MIDI conversion MIDIToMusic
  MusicToMIDI
Notification AddNotificationType
  GetNotificationPMsg
  RemoveNotificationType
  SetNotificationHandle
Parameters GetGlobalParam
  GetParam
  SetGlobalParam
  SetParam
Ports AddPort
  RemovePort
Segments GetSegmentState
  IsPlaying
  PlaySegment
  Stop
Timing AdjustTime
  GetBumperLength
  GetLatencyTime
  GetPrepareTime
  GetQueueTime
  GetResolvedTime
  GetTime
  MusicToReferenceTime
  ReferenceToMusicTime
  RhythmToTime
  SetBumperLength
  SetPrepareTime
  TimeToRhythm
Tools GetGraph
  SetGraph
Miscellaneous CloseDown
  Init
  Invalidate

All COM interfaces inherit the IUnknown interface methods. This interface supports the following methods:

IUnknown AddRef
  QueryInterface
  Release

Requirements

OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.

 Last updated on Monday, April 12, 2004

© 1992-2002 Microsoft Corporation. All rights reserved.