The IDirectMusicPort interface provides access to a DirectMusicPort object, which represents a device that sends or receives music data. The input port of an MPU-401, the output port of an MPU-401, the Microsoft Software Synthesizer, and an IHV-provided filter are all ports. Note that a physical device such as an MPU-401 may provide multiple ports. A single port, however, cannot both capture and render data.
For an overview, see Using Ports.
The methods of the IDirectMusicPort interface can be organized into the following groups:
Buffers | PlayBuffer |
Read | |
SetReadNotificationHandle | |
Channels | GetChannelPriority |
GetNumChannelGroups | |
SetChannelPriority | |
SetNumChannelGroups | |
Device management | Activate |
DeviceIoControl | |
SetDirectSound | |
Information | GetCaps |
GetFormat | |
GetLatencyClock | |
GetRunningStats | |
Downloadable sounds | Compact |
DownloadInstrument | |
UnloadInstrument |
All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods:
IUnknown | AddRef |
QueryInterface | |
Release |
The LPDIRECTMUSICPORT type is defined as a pointer to the IDirectMusicPort interface:
typedef IDirectMusicPort *LPDIRECTMUSICPORT;
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dmusicc.h.