IDeviceTopology Interface

IDeviceTopology Interface

The IDeviceTopology interface provides access to the topology of an audio device. The topology of an audio adapter device consists of the data paths that lead to and from audio endpoint devices and the control points that lie along the paths. An audio endpoint device also has a topology, but it is trivial, as explained in Device Topologies. A client obtains a reference to the IDeviceTopology interface for an audio endpoint device by following these steps:

1. By using one of the techniques described in IMMDevice Interface, obtain a reference to the IMMDevice interface for an audio endpoint device.
2. Call the IMMDevice::Activate method with parameter refiid set to REFIID IID_IDeviceTopology.

After obtaining the IDeviceTopology interface for an audio endpoint device, an application can explore the topologies of the audio adapter devices to which the endpoint device is connected.

For code examples that use the IDeviceTopology interface, see the implementations of the GetHardwareDeviceTopology and SelectCaptureDevice functions in Device Topologies.

IDeviceTopology inherits from the IUnknown interface. In addition to the methods inheriteds from IUnknown, IDeviceTopology supports the following methods.

Requirements

Client: Windows Vista

Header: Include Devicetopology.h.

See Also

• DeviceTopology API
• IMMDevice::Activate