reGFILTERPINS 结构 (strmif.h)

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

指向大小 nMediaTypesREGPINTYPES 结构的数组的指针。

注解

此结构在 IFilterMapper2 接口中用于筛选器注册。 如果使用此结构,请将 REGFILTER2 结构的 dwVersion 成员设置为 1。 如果需要为引脚注册介质或引脚类别,请改用 REGFILTERPINS2 结构。 在这种情况下,将 REGFILTER2 结构的 dwVersion 成员设置为 2。

等效 AMOVIESETUP_PIN 类型用于类工厂模板 (CFactoryTemplate) 。

strNameclsConnectsToFilterstrConnectsToPin 成员已过时。 其值不会添加到注册表中。

有关详细信息,请参阅 如何注册 DirectShow 筛选器

要求

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

另请参阅

DirectShow 结构