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

Метод IAMFilterData::CreateFilterData

  • Статья

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

Примечание

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

 

Метод создает двоичные CreateFilterData данные реестра для фильтра. Эти данные можно записать в реестр в виде подраздела REG_BINARY с именем FilterData в разделе CLSID фильтра.

Как правило, нет причин для того, чтобы приложение вызывало этот метод. Метод IFilterMapper2::RegisterFilter автоматически создает двоичные данные и добавляет их в правильное расположение в реестре. Дополнительные сведения см. в разделе Регистрация фильтров DirectShow.

Синтаксис

HRESULT CreateFilterData(
  [in]  REGFILTER2 *prf2,
  [out] BYTE       **prgbFilterData,
  [out] ULONG      *pcb
);

Параметры

prf2 [in]

Указатель на структуру REGFILTER2 , содержащую сведения о фильтре.

prgbFilterData [out]

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

pcb [out]

Указатель на переменную, которая получает размер двоичных данных в байтах.

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

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

Комментарии

Примечание

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

 

Требования

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

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

Интерфейс IAMFilterData