Структура 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.
Требования
| Требование | Значение |
|---|---|
| Заголовок | strmif.h (включая Dshow.h) |