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

  • Статья

Интерфейс IKsFormatSupport предоставляет сведения о форматах аудиоданных, поддерживаемых программным подключением ввода-вывода (обычно это канал DMA) между аудиоадаптером и системной памятью. Клиент получает ссылку на интерфейс IKsFormatSupport части, вызывая метод IPart::Activate с параметром refiid , для IID_IKsFormatSupport задано значение REFIID. Вызов IPart::Activate завершается успешно, только если часть поддерживает интерфейс IKsFormatSupport . Только объект part, представляющий соединитель с Software_IO типом подключения, будет поддерживать этот интерфейс. Дополнительные сведения о Software_IO см. в разделе Перечисление ConnectorType.

Большинство драйверов аудиоадаптера Windows поддерживают модель драйвера Windows (WDM) и используют свойства потоковой передачи ядра (KS) для представления параметров описания оборудования в соединителях (называемых контактами KS). Интерфейс IKsFormatSupport обеспечивает удобный доступ к свойствам KSPROPERTY_PIN_DATAINTERSECTION и KSPROPERTY_PIN_PROPOSEDDATAFORMAT соединителя к системной шине (обычно PCI или PCI Express) или внешней шине (например, USB). Не все драйверы поддерживают свойство KSPROPERTY_PIN_PROPOSEDDATAFORMAT. Если драйвер не поддерживает это свойство, IKsFormatSupport использует сведения из диапазонов данных KS для соединителя, чтобы определить, поддерживает ли соединитель предлагаемый формат. Дополнительные сведения о свойствах KS, контактах KS и диапазонах данных KS см. в документации по Windows DDK.

Наследование

Интерфейс IKsFormatSupport наследуется от интерфейса IUnknown . IKsFormatSupport также имеет следующие типы элементов:

Методы

Интерфейс IKsFormatSupport содержит следующие методы.

 
IKsFormatSupport::GetDevicePreferredFormat

Метод GetDevicePreferredFormat получает предпочтительный формат аудиопотока для подключения.
IKsFormatSupport::IsFormatSupported

Метод IsFormatSupported указывает, поддерживает ли устройство конечной точки аудио указанный формат аудиопотока.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header devicetopology.h

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

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

DeviceTopology API

IPart::Activate