| Platform SDK: DirectX |
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. A physical device such as an MPU-401 might 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.