Skip to content

Latest commit

 

History

History
77 lines (61 loc) · 3.22 KB

nn-devicetopology-idevicetopology.md

File metadata and controls

77 lines (61 loc) · 3.22 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:devicetopology.IDeviceTopology
IDeviceTopology (devicetopology.h)
The IDeviceTopology interface provides access to the topology of an audio device.
IDeviceTopology
IDeviceTopology interface [Core Audio]
IDeviceTopology interface [Core Audio]
described
coreaudio.idevicetopology
devicetopology/IDeviceTopology
coreaudio\idevicetopology.htm
CoreAudio
1b509f69-6277-40c0-a293-02afc30d464a
12/05/2018
IDeviceTopology, IDeviceTopology interface [Core Audio], IDeviceTopology interface [Core Audio],described, coreaudio.idevicetopology, devicetopology/IDeviceTopology
devicetopology.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Windows
19H1
IDeviceTopology
devicetopology/IDeviceTopology
c++
APIRef
kbSyntax
COM
Devicetopology.h
IDeviceTopology

IDeviceTopology interface

-description

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.

-inheritance

The IDeviceTopology interface inherits from the IUnknown interface. IDeviceTopology also has these types of members:

-see-also

Core Audio Interfaces

DeviceTopology API

IMMDevice::Activate