Структура REGFILTERPINS (strmif.h)

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

Структура REGFILTERPINS содержит сведения о закреплении для регистрации фильтра.

Синтаксис

typedef struct REGFILTERPINS {
  LPWSTR            strName;
  BOOL              bRendered;
  BOOL              bOutput;
  BOOL              bZero;
  BOOL              bMany;
  const CLSID       *clsConnectsToFilter;
  const WCHAR       *strConnectsToPin;
  UINT              nMediaTypes;
  const REGPINTYPES *lpMediaType;
} REGFILTERPINS;

Члены

strName

Имя булавки. (Является устаревшим.)

bRendered

Если задано значение TRUE, фильтр отрисовывает входные данные из этого закрепления. (Применяется только к входным контактам. Для выходных контактов значение всегда равно FALSE.)

bOutput

Если задано значение TRUE, это выходная закрепка. В противном случае контакт будет входным.

bZero

Если задано значение TRUE, фильтр может содержать ноль экземпляров этого закрепления.

bMany

Если задано значение TRUE, фильтр может создать несколько экземпляров такого типа закрепления.

clsConnectsToFilter

Идентификатор класса (CLSID) фильтра, к которому подключается этот контакт. (Является устаревшим.)

strConnectsToPin

Имя контакта, к которому подключается этот контакт. (Является устаревшим.)

nMediaTypes

Количество типов носителей, поддерживаемых этим закреплением.

lpMediaType

Указатель на массив структур REGPINTYPES размером nMediaTypes.

Комментарии

Эта структура используется в интерфейсе IFilterMapper2 для регистрации фильтра. Если вы используете эту структуру, задайте для элемента dwVersion структуры REGFILTER2 значение 1. Если вам нужно зарегистрировать категорию средних или контактных данных для закрепления, используйте вместо этого структуру REGFILTERPINS2 . В этом случае задайте для элемента dwVersion структуры REGFILTER2 значение 2.

Эквивалентный тип AMOVIESETUP_PIN используется в шаблонах фабрики классов (CFactoryTemplate).

Элементы strName, clsConnectsToFilter и strConnectsToPin устарели. Их значения не добавляются в реестр.

Дополнительные сведения см. в разделе Регистрация фильтров DirectShow.

Требования

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

Структуры DirectShow