Интерфейс IDeviceSpecificProperty (devicetopology.h)
Интерфейс IDeviceSpecificProperty предоставляет доступ к значению элемента управления для конкретного устройства. Клиент получает ссылку на интерфейс IDeviceSpecificProperty части, вызывая метод IPart::Activate с параметром refiid , равным REFIID IID_IDeviceSpecificProperty. Вызов IPart::Activate завершается успешно, только если часть поддерживает интерфейс IDeviceSpecificProperty . Часть поддерживает этот интерфейс только в том случае, если базовый аппаратный элемент управления имеет значение элемента управления для конкретного устройства и элемент управления не может быть адекватно представлен каким-либо другим интерфейсом в API DeviceTopology.
Как правило, свойство конкретного устройства полезно только для клиента, который может определить значение свойства на основе таких сведений, как тип части, подтип части и имя части. Клиент может получить эти сведения, вызвав методы IPart::GetPartType, IPart::GetSubType и IPart::GetName .
Большинство драйверов аудиоадаптера Windows поддерживают модель драйвера Windows (WDM) и используют свойства потоковой передачи ядра (KS) для представления параметров управления оборудованием в подсоединителях (называемых узлами KS). Интерфейс IDeviceSpecificProperty предоставляет удобный доступ к свойству KSPROPERTY_AUDIO_DEV_SPECIFIC подсоединения со значением GUID подтипа KSNODETYPE_DEV_SPECIFIC. Чтобы получить GUID подтипа подъединицы, вызовите метод IPart::GetSubType . Дополнительные сведения о свойствах KS и типах узлов KS см. в документации по Windows DDK.
Наследование
Интерфейс IDeviceSpecificProperty наследуется от интерфейса IUnknown . IDeviceSpecificProperty также имеет следующие типы элементов:
Методы
Интерфейс IDeviceSpecificProperty содержит следующие методы.
| IDeviceSpecificProperty::Get4BRange Метод Get4BRange получает 4-байтовой диапазон значения свойства устройства. |
| IDeviceSpecificProperty::GetType Метод GetType получает тип данных значения свойства устройства. |
| IDeviceSpecificProperty::GetValue Метод GetValue получает текущее значение свойства устройства. |
| IDeviceSpecificProperty::SetValue Метод SetValue задает значение свойства для конкретного устройства. |
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | devicetopology.h |