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


Наборы свойств (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: