Поделиться через


Наборы свойств (DirectShow)

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

Microsoft DirectShow использует наборы свойств для поддержки расширенных служб, предлагаемых оборудованием, а также связанных с ним драйверов и фильтров. Поставщики оборудования и фильтров могут определять новые возможности как свойства, упорядочивать их в наборах свойств и публиковать спецификации для этих наборов свойств. Разработчик приложения может использовать методы интерфейса IKsPropertySet , чтобы определить, поддерживает ли драйвер или фильтр определенный набор свойств, а также получить или задать эти свойства.

Для всех методов, предоставляемых IKsPropertySet , требуется ИДЕНТИФИКАТОР GUID , определяющий набор свойств (параметр guidPropSet ), и DWORD , определяющий свойство в наборе свойств (параметр dwPropID ). Параметр dwPropID обычно является членом перечислимого типа данных.

Отдельные свойства могут содержать связанные данные, указанные в параметре pPropData в методах IKsPropertySet::Set и IKsPropertySet::Get . В этих методах данные свойства типитируются как указатель на void. Тип данных и значение данных указываются в определении набора свойств.

В следующих разделах содержатся сведения о наборах свойств, поддерживаемых в DirectShow.