Microsoft DirectX 8.0 (C++) |
The IDirectMusicPort8 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.
IDirectMusicPort8 is a define for IDirectMusicPort. The two interface names are interchangeable.
The interface is typically obtained by using the IDirectMusic8::CreatePort method.
For an overview, see Using DirectMusic Ports.
The methods of the IDirectMusicPort8 interface can be organized into the following groups.
Buffers | PlayBuffer |
Read | |
SetReadNotificationHandle | |
Channels | GetChannelPriority |
GetNumChannelGroups | |
SetChannelPriority | |
SetNumChannelGroups | |
Device management | Activate |
DeviceIoControl | |
SetDirectSound | |
DLS data | Compact |
DownloadInstrument | |
UnloadInstrument | |
Information | GetCaps |
GetFormat | |
GetLatencyClock | |
GetRunningStats |
All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods.
IUnknown | AddRef |
QueryInterface | |
Release |
The LPDIRECTMUSICPORT8 type is defined as a pointer to the IDirectMusicPort8 interface.
typedef IDirectMusicPort8 *LPDIRECTMUSICPORT8;
Header: Declared in dmusicc.h.