Метод IAMFilterData::CreateFilterData

Статья
07/28/2023

[Функция, связанная с этой страницей 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
DLL	Quartz.dll

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

Интерфейс IAMFilterData

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