IFilterMapper：：RegisterFilterInstance 方法 (strmif.h)

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

语法

HRESULT RegisterFilterInstance(
  [in]  CLSID   clsid,
  [in]  LPCWSTR Name,
  [out] CLSID   *MRId
);

参数

[in] clsid

筛选器的 GUID。

[in] Name

实例的描述性名称。

[out] MRId

指向返回的媒体资源 ID 的指针。 此参数是此筛选器实例的本地唯一标识符。

返回值

返回 HRESULT 值。

注解

此方法处理以下情况：当同一驱动程序驱动的两个相似声卡可用时，需要选择哪个卡发出声音。 如果只有一个筛选器实例 (，例如计算机) 中只有一个声音卡，或者筛选器的所有实例都是等效的，则不需要这样做。

筛选器本身必须已注册。

要求

另请参阅

错误和成功代码

IFilterMapper 接口