REGFILTER2 结构 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 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 结构。

要求

要求
Header strmif.h (包括 Dshow.h)

另请参阅

DirectShow 结构