Интерфейс IPart (devicetopology.h)
Интерфейс IPart представляет часть топологии устройства (соединитель или подсоединие). Клиент получает ссылку на интерфейс IPart путем вызова метода IDeviceTopology::GetPartById или IPartsList::GetPart либо путем вызова метода QueryInterface интерфейса IConnector или ISubunit в объекте части и задания для параметра iid метода значения REFIID IID_IPart.
Объект с интерфейсом IPart может инкапсулировать одну из следующих частей топологии устройства:
- Соединителя. Это часть, которая подключается к другому устройству для формирования пути данных для передачи аудиопотока между устройствами.
- Подсоединие. Это часть, которая обрабатывает аудиопоток (например, управление громкости).
Интерфейс IPart предоставляет методы для получения имени, локального идентификатора, глобального идентификатора и типа части соединителя или подсоединения. Кроме того, IPart может активировать интерфейс управления для соединителя или подсоединия.
Примеры кода, использующие интерфейс IPart , см. в реализациях функций GetHardwareDeviceTopology и SelectCaptureDevice в топологиях устройств.
Наследование
Интерфейс IPart наследуется от интерфейса IUnknown . IPart также имеет следующие типы членов:
Методы
Интерфейс IPart содержит следующие методы.
| IPart::Activate Метод Activate активирует интерфейс для конкретной функции в соединителе или подсоедините. |
| IPart::EnumPartsIncoming Метод EnumPartsIncoming получает список всех входящих частей, то есть частей, которые находятся в путях к данным, вышестоящий из этой части. |
| IPart::EnumPartsOutgoing Метод EnumPartsOutgoing извлекает список всех исходящих частей, т. е. частей, которые находятся в путях к данным, которые находятся ниже по этой части. |
| IPart::GetControlInterface Метод GetControlInterface получает ссылку на указанный интерфейс элемента управления, если эта часть поддерживает его. |
| IPart::GetControlInterfaceCount Метод GetControlInterfaceCount получает количество интерфейсов управления, поддерживаемых этой частью. |
| IPart::GetGlobalId Метод GetGlobalId получает глобальный идентификатор этой части. |
| IPart::GetLocalId Метод GetLocalId получает локальный идентификатор этой части. |
| IPart::GetName Метод GetName получает понятное имя этой части. |
| IPart::GetPartType Метод GetPartType получает тип части этой части. |
| IPart::GetSubType Метод GetSubType получает подтип части этой части. |
| IPart::GetTopologyObject Метод GetTopologyObject получает ссылку на интерфейс IDeviceTopology объекта device-topology, содержащего эту часть. |
| IPart::RegisterControlChangeCallback Метод RegisterControlChangeCallback регистрирует интерфейс IControlChangeNotify, который клиент реализует для получения уведомлений об изменениях состояния в этой части. |
| IPart::UnregisterControlChangeCallback Метод UnregisterControlChangeCallback удаляет регистрацию интерфейса IControlChangeNotify, который клиент ранее зарегистрировал путем вызова метода IPart::RegisterControlChangeCallback. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | devicetopology.h |