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

Метод IAMFilterData::P arseFilterData

  • Статья

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

Примечание

Этот интерфейс не рекомендуется к использованию. Новые приложения не должны использовать его.

 

Метод ParseFilterData распаковывает двоичные данные реестра для фильтра.

Как правило, нет причин для того, чтобы приложение вызывало этот метод. Метод IFilterMapper2::EnumMatchingFilters предоставляет более удобный способ доступа к данным реестра фильтров.

Синтаксис

HRESULT ParseFilterData(
  [in]  BYTE  *rgbFilterData,
  [in]  ULONG cb,
  [out] BYTE  **prgbRegFilter2
);

Параметры

rgbFilterData [in]

Указатель на двоичные данные реестра. Эти данные можно получить, получите свойство FilterData из моникера фильтра. Данные хранятся в виде SAFEARRAY байтов (VT_UI1 | VT_ARRAY).

cb [in]

Задает размер двоичных данных в байтах.

prgbRegFilter2 [out]

Адрес переменной, получающей указатель на неупакованные данные. Когда метод возвращает, приведите этот указатель к типу REGFILTER2 для доступа к данным фильтра. Вызывающий объект должен освободить память, вызвав метод CoTaskMemFree .

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Примечание

Заголовок Fil_data.h находится в каталоге Mapper Sample в пакете Windows SDK.

 

Требования

Требование Значение
Заголовок
Fil_data.h
DLL
Quartz.dll

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

Интерфейс IAMFilterData