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

структура REGFILTER2 (strmif.h)

  • Статья

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

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

Синтаксис

typedef struct REGFILTER2 {
  DWORD dwVersion;
  DWORD dwMerit;
  union {
    struct {
      ULONG               cPins;
      const REGFILTERPINS *rgPins;
    } DUMMYSTRUCTNAME;
    struct {
      ULONG                cPins2;
      const REGFILTERPINS2 *rgPins2;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME;
} REGFILTER2;

Члены

dwVersion

Формат регистрации фильтра. Если значение равно 1, объединение содержит первую неименованную структуру. Если значение равно 2, объединение содержит вторую неименованную структуру.

dwMerit

Фильтрация заслуг. Сначала перечисляются фильтры с более высокими достоинствами. См . заслуги.

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.cPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME.rgPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.cPins2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.rgPins2

Комментарии

Эта структура передается в метод IFilterMapper2::RegisterFilter .

Если вам нужно зарегистрировать среды или категории закреплений, задайте для dwVersion значение 2 и используйте структуру REGFILTERPINS2 .

Требования

Требование Значение
Заголовок strmif.h (включая Dshow.h)

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

Структуры DirectShow