Interfaz IPart (devicetopology.h)

La interfaz IPart representa una parte (conector o subunidad) de una topología de dispositivo. Un cliente obtiene una referencia a una interfaz IPart llamando al método IDeviceTopology::GetPartById o IPartsList::GetPart , o llamando al método QueryInterface de la interfaz IConnector o ISubunit en un objeto part y estableciendo el parámetro iid del método en REFIID IID_IPart.

Un objeto con una interfaz IPart puede encapsular una de las siguientes partes de topología de dispositivo:

• Conector. Esta es una parte que se conecta a otro dispositivo para formar una ruta de acceso de datos para transmitir una secuencia de audio entre dispositivos.
• Subunidad. Esta es una parte que procesa una secuencia de audio (por ejemplo, control de volumen).

La interfaz IPart de un conector o un objeto de subbúnit representa las funciones genéricas que son comunes a todas las partes, y la interfaz IConnector o ISubunit del objeto representa las funciones específicas de un conector o subbúnit. Además, una parte podría admitir una o varias interfaces de control para controlar o supervisar la función de la pieza. Por ejemplo, el cliente controla una subunidad de control de volumen a través de su interfaz IAudioVolumeLevel .

La interfaz IPart proporciona métodos para obtener el nombre, el identificador local, el identificador global y el tipo de pieza de un conector o subunidad. Además, IPart puede activar una interfaz de control en un conector o subunidad.

Para obtener ejemplos de código que usan la interfaz IPart , consulte las implementaciones de las funciones GetHardwareDeviceTopology y SelectCaptureDevice en Topologías de dispositivo.

Herencia

La interfaz IPart hereda de la interfaz IUnknown . IPart también tiene estos tipos de miembros:

Métodos

La interfaz IPart tiene estos métodos.

IPart::Activate El método Activate activa una interfaz específica de la función en un conector o subunidad.
IPart::EnumPartsIncoming El método EnumPartsIncoming obtiene una lista de todas las partes entrantes que es decir, las partes que residen en rutas de acceso de datos que están ascendentes desde esta parte.
IPart::EnumPartsOutgoing El método EnumPartsOutgoing recupera una lista de todas las partes salientes que es, las partes que residen en rutas de acceso de datos que están de bajada de esta parte.
IPart::GetControlInterface El método GetControlInterface obtiene una referencia a la interfaz de control especificada, si esta parte la admite.
IPart::GetControlInterfaceCount El método GetControlInterfaceCount obtiene el número de interfaces de control que admite esta parte.
IPart::GetGlobalId El método GetGlobalId obtiene el identificador global de esta parte.
IPart::GetLocalId El método GetLocalId obtiene el identificador local de esta parte.
IPart::GetName El método GetName obtiene el nombre descriptivo de esta parte.
IPart::GetPartType El método GetPartType obtiene el tipo de pieza de esta parte.
IPart::GetSubType El método GetSubType obtiene el subtipo de parte de esta parte.
IPart::GetTopologyObject El método GetTopologyObject obtiene una referencia a la interfaz IDeviceTopology del objeto device-topology que contiene esta parte.
IPart::RegisterControlChangeCallback El método RegisterControlChangeCallback registra la interfaz IControlChangeNotify, que el cliente implementa para recibir notificaciones de cambios de estado en esta parte.
IPart::UnregisterControlChangeCallback El método UnregisterControlChangeCallback quita el registro de una interfaz IControlChangeNotify que el cliente registró previamente mediante una llamada al método IPart::RegisterControlChangeCallback.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	devicetopology.h

Consulte también

Interfaces de audio principales

DeviceTopology API

IAudioVolumeLevel (Interfaz)

IConnector (Interfaz)

IDeviceTopology::GetPartById

IPartsList::GetPart

ISubunit (interfaz)