IMiniportTopology interface (portcls.h)

The IMiniportTopology interface is the primary interface of a Topology miniport driver. Through this interface, the miniport driver exposes the topology of the mixing circuitry in an audio adapter. In a typical adapter, this circuitry mixes together the playback streams from the wave renderer and MIDI synthesizer. The Topology port driver communicates with the miniport driver through the IMiniportTopology interface. The adapter driver creates the topology miniport object and passes the object's IMiniportTopology interface pointer to the topology port driver's IPort::Init method (see the code example in Subdevice Creation). IMiniportTopology inherits from the IMiniport interface.

An adapter driver forms a miniport/port driver pair by binding an IMiniportTopology object to an IPortTopology object. The PortCls system driver registers this pair with the system as a topology filter.

Through a sequence of property requests, the mixer API uses the topology filter to enumerate the pins, nodes, and connections that comprise the internal topology of the audio adapter. The filter also supports the acquisition of control-change information. The pins of a topology filter represent hardwired connections within the adapter and therefore cannot be instantiated. For more information, see Kernel Streaming Topology to Audio Mixer API Translation.

Inheritance

The IMiniportTopology interface inherits from the IMiniport interface.

Methods

The IMiniportTopology interface has these methods.

 
IMiniportTopology::Init

The Init method initializes the topology miniport object.

Requirements

Requirement Value
Target Platform Windows
Header portcls.h