|
midiOutShortMsg
The midiOutShortMsg function sends a short MIDI message to the specified MIDI output device.
MMRESULT midiOutShortMsg(
HMIDIOUT hmo,
|
| DWORD dwMsg
|
| );
|
|
Parameters
hmo
Handle of the MIDI output device. This parameter can also be the handle of a
MIDI stream cast to HMIDIOUT.
dwMsg
MIDI message. The message is packed into a doubleword value with the first
byte of the message in the low-order byte. The message is packed into this
parameter as follows:
High word
| High-order byte
| Not used.
|
| Low-order byte
| Contains a second byte of MIDI data (when needed).
| Low word
| High-order byte
| Contains the first byte of MIDI data (when needed).
|
| Low-order byte
| Contains the MIDI status.
|
The two MIDI data bytes are optional, depending on the MIDI status byte. When
a series of messages have the same status byte, the status byte can be omitted
from messages after the first one in the series, creating a running status.
Pack a message for running status as follows:
High word
| High-order byte
| Not used.
|
| Low-order byte
| Not used.
| Low word
| High-order byte
| Contains a second byte of MIDI data (when needed).
|
| Low-order byte
| Contains the first byte of MIDI data.
|
Return Values
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error
values include the following:
MIDIERR_BADOPENMODE
| The application sent a message without a status byte to a stream handle.
| MIDIERR_NOTREADY
| The hardware is busy with other data.
| MMSYSERR_INVALHANDLE
| The specified device handle is invalid.
|
Remarks
This function is used to send any MIDI message except for system-exclusive or
stream messages.
This function might not return until the message has been sent to the output
device. You can send short messages while streams are playing on the same device
(although you cannot use a running status in this case).
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Programmer's Reference (win32.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
