DirectX SDK

IDirectMusicPort

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;

Requirements

  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.