Интерфейс IKsPropertySet

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Изначально IKsPropertySet интерфейс был разработан как эффективный способ установки и получения свойств устройства в драйверах WDM с помощью KSProxy для преобразования вызовов com-методов пользовательского режима в наборы свойств режима ядра, используемые драйверами класса потоковой передачи WDM. Этот интерфейс теперь также используется для передачи информации строго между компонентами программного обеспечения.

В некоторых случаях программные компоненты должны реализовывать либо этот интерфейс, либо интерфейс IKsControl (задокументировано в DirectShow DDK). Например, при написании программного декодера MPEG-2 для использования с DVD-навигатором необходимо реализовать один из этих интерфейсов, а также поддерживать наборы свойств, связанных с DVD, которые навигатор будет отправлять декодеру. Контакты могут поддерживать один из этих интерфейсов, чтобы разрешить другим контактам или фильтрам задавать или извлекать свои свойства.

Примечание

Другой интерфейс с таким именем существует в файле заголовка dsound.h. Эти два интерфейса несовместимы. Интерфейс IKsControl , описанный в directShow DDK, теперь является рекомендуемым интерфейсом для передачи наборов свойств между драйверами WDM и компонентами пользовательского режима.

 

Элементы

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

Методы

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

Метод Описание
Получить Извлекает свойство, определяемое идентификатором GUID набора свойств и идентификатором свойства.
QuerySupported Определяет, поддерживает ли объект указанный набор свойств.
Присвойте параметру Задает свойство, определяемое идентификатором GUID набора свойств и идентификатором свойства.

 

Комментарии

Необходимо включить Ks.h перед Ksproxy.h.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Ksproxy.h
Библиотека
Strmiids.lib

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

Наборы свойств