IMMSequencer

The IMMSequencer class is the base class for MIDI (Musical Instrument Digital Interface) playback. MIDI is a standard specification for playing back music from a series of commands, rather than from actual audio data. The commands represent musical events, such as turning a note on and off, as well as timing mechanisms for specifying the duration of the note's sound.


IMMSequencer - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class.


[view class]
~IMMSequencer
public:
virtual ~IMMSequencer()

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
IMMSequencer


Overload 1
public:
IMMSequencer( bool openNow = true, unsigned long instance = 0, bool openShareable = true )

You can construct an IMMSequencer from the following:

openNow
If true, it causes the device to automatically open the device before returning from the constructor; otherwise, you would have to call one of the open functions to open the device yourself.
instance
You can provide your own instance number instead of letting IMMSequencer generate one.
openShareable
If true, it allows the hardware device to be shared by different programs; otherwise, the hardware cannot be shared.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


Overload 2
protected:
IMMSequencer( unsigned long deviceIdentifier, const IString& newAlias = IString ( ) )

A derived class can construct an IMMSequencer from the following:

deviceIdentifier
The value the system uses to identify the device.
newAlias
The name you can use to associate a string to the device. Optional.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


Implementation

These members check if the passed-in string is in the correct format to open the current device.


[view class]
resume
public:
virtual IMMSequencer& resume( bool resume = true, CallType call = wait )

Resumes playback of the device from a paused state if resume is true.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
setVolume
public:
virtual IMMSequencer& setVolume( unsigned long volume, AudioChannel channel = all, const IMMMillisecondTime& over = IMMMillisecondTime ( ), CallType call = wait )

Sets the volume of the audio channel for the device, where 0 is the least amount of volume and 100 is the most amount of volume.

Supported Platforms

Windows OS/2 AIX
Yes Yes No

Portability Considerations

This member is overridden in this derived class for specific operating system behavior.


[view class]
volume
public:
virtual unsigned long volume( AudioChannel channel = left, CallType call = wait ) const

Returns the volume of the audio channel for the device, where 0 is the least amount of volume and 100 is the most amount of volume.

Supported Platforms

Windows OS/2 AIX
Yes Yes No

Portability Considerations

This member is overridden in this derived class for specific operating system behavior.


[view class]
isOpenStringValid
protected:
virtual bool isOpenStringValid( const IString& deviceName ) const

Returns true if the passed-in open string is valid for this device.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
restoreDeviceSettings
protected:
virtual IMMSequencer& restoreDeviceSettings( bool newRecordMode = false )

Restores settings for the current device. Derived classes should override this function, handle class-specific settings, and call the corresponding inherited function.

Supported Platforms

Windows OS/2 AIX
Yes No No


[view class]
saveDeviceSettings
protected:
virtual IMMSequencer& saveDeviceSettings()

Saves settings for the current device. Derived classes should override this function, handle class-specific settings, and call the corresponding inherited function.

Supported Platforms

Windows OS/2 AIX
Yes No No


IMMSequencer - Inherited Member Functions and Data

Inherited Public Functions

IMMDevice
IMMFileMedia
IMMPlayableDevice
INotifier
IStandardNotifier

Inherited Public Data

INotifier
IMMDevice

Inherited Protected Functions

INotifier
IStandardNotifier
IMMDevice
IMMFileMedia
IMMPlayableDevice

Inherited Protected Data