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.IPart

IPart (devicetopology.h)

The IPart interface represents a part (connector or subunit) of a device topology.

IPart

IPart interface [Core Audio]

described

coreaudio.ipart

devicetopology/IPart

coreaudio\ipart.htm

CoreAudio

3bcfab9f-fad8-4605-8780-0b7c2068fcdf

12/05/2018

IPart, IPart interface [Core Audio], IPart interface [Core Audio],described, coreaudio.ipart, devicetopology/IPart

devicetopology.h

Windows

Windows Vista [desktop apps only]

Windows Server 2008 [desktop apps only]

Windows

19H1

IPart

devicetopology/IPart

c++

APIRef

kbSyntax

COM

Devicetopology.h

IPart

IPart interface

-description

The IPart interface represents a part (connector or subunit) of a device topology. A client obtains a reference to an IPart interface by calling the IDeviceTopology::GetPartById or IPartsList::GetPart method, or by calling the QueryInterface method of the IConnector or ISubunit interface on a part object and setting the method's iid parameter to REFIID IID_IPart.

An object with an IPart interface can encapsulate one of the following device topology parts:

Connector. This is a part that connects to another device to form a data path for transmitting an audio stream between devices.
Subunit. This is a part that processes an audio stream (for example, volume control).

The IPart interface of a connector or subunit object represents the generic functions that are common to all parts, and the object's IConnector or ISubunit interface represents the functions that are specific to a connector or subunit. In addition, a part might support one or more control interfaces for controlling or monitoring the function of the part. For example, the client controls a volume-control subunit through its IAudioVolumeLevel interface.

The IPart interface provides methods for getting the name, local ID, global ID, and part type of a connector or subunit. In addition, IPart can activate a control interface on a connector or subunit.

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