通过

IFilterMapper：：RegisterPin 方法 (strmif.h)

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意IFilterMapper 接口已弃用。 请改用 IFilterMapper2 。
 
记录注册表中固定的详细信息。

语法

HRESULT RegisterPin(
  [in] CLSID   Filter,
  [in] LPCWSTR Name,
  [in] BOOL    bRendered,
  [in] BOOL    bOutput,
  [in] BOOL    bZero,
  [in] BOOL    bMany,
  [in] CLSID   ConnectsToFilter,
  [in] LPCWSTR ConnectsToPin
);

参数

[in] Filter

筛选器的 GUID。

[in] Name

图钉的名称。 这在筛选器中应是唯一的。 它除了指示类型信息外没有意义。 不应使用超过 99 个字符的固定名称，因为这会导致筛选器枚举问题。

[in] bRendered

指定筛选器是否呈现此输入的值。 如果确实如此，则设置为 TRUE ;否则，设置为 FALSE。

[in] bOutput

指定此是否为输出引脚的值。 如果为 ， 则设置为 TRUE;否则，设置为 FALSE。

[in] bZero

指定筛选器是否可以具有此引脚的零个实例的值。 如果可以，则设置为 TRUE;否则，设置为 FALSE。 例如，解压缩筛选器不需要为没有音轨的电影创建声音输出引脚。

[in] bMany

指定筛选器是否可以具有此引脚的多个实例的值。 如果可以，则设置为 TRUE;否则，设置为 FALSE。 例如，混音器可能具有其输入引脚的多个实例。

[in] ConnectsToFilter

保留。 必须为 NULL。 (这适用于筛选器，例如在筛选器图外部具有连接的系统范围混音器。尚未实现。)

[in] ConnectsToPin

保留。 必须为 NULL。

返回值

返回 HRESULT 值。

要求

要求 值
目标平台 Windows
标头 strmif.h (包括 Dshow.h)

另请参阅

错误和成功代码

IFilterMapper 接口