Microsoft DirectX 8.0 (C++)

IDirectMusicPort8

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;

Requirements

  Header: Declared in dmusicc.h.