Интерфейс IDeviceSpecificProperty (devicetopology.h)

Статья
08/23/2023

Интерфейс 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

См. также раздел

Основные звуковые интерфейсы