IPin：：QueryInternalConnections 方法 (strmif.h)

  • 项目

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

QueryInternalConnections 方法检索在筛选器) 内部连接到此引脚 (的引脚。

语法

HRESULT QueryInternalConnections(
  [out]     IPin  **apPin,
  [in, out] ULONG *nPin
);

参数

[out] apPin

IPin 指针数组的地址。 调用方分配数组。 方法使用 IPin 指针填充数组。 如果 nPin 为零，则此参数可以为 NULL。

[in, out] nPin

输入时，指定数组的大小。 输出时，指定内部连接的引脚数。

返回值

返回 HRESULT 值。 可能的值包括以下值。

返回代码 说明
S_FALSE
 数组大小不足。
S_OK
 成功。
E_NOTIMPL
 未实现。

注解

此方法返回有关筛选器的输入引脚到输出引脚的内部映射的信息。 换句话说，它描述了输入引脚如何将数据传递到输出引脚。

在大多数筛选器中，每个输入引脚都连接到每个输出引脚。 例如，在转换筛选器中，一个输入连接到一个输出;在拆分器筛选器中，一个输入连接到多个输出。 在这些情况下，方法应仅返回E_NOTIMPL。

否则，方法将返回 IPin 指针数组，其中每个引脚在内部映射到已查询的引脚。 如果在输入引脚上调用 方法，则数组包含指向输出引脚的指针，反之亦然。

调用方分配 IPin 指针数组。 若要获取所需的数组大小，请在 apPin 等于 NULL 的情况下调用方法一次。 大小在 nPin 参数中返回。 然后分配数组并再次调用 方法，将 apPin 设置为等于数组的地址， 将 nPin 设置为等于数组大小。 然后， 方法使用 IPin 指针填充数组。 每个返回的指针都有未完成的引用计数，必须由调用方释放。

此方法还有一个现已弃用的用途：如果至少有一个输入引脚实现了此方法，但在 nPin 中返回零，则 Filter Graph 管理器会将筛选器视为呈现器筛选器。 但是，如果要编写新的呈现器筛选器，则应实现 IAMFilterMiscFlags 接口，而不是使用此方法来指示筛选器是呈现器。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IPin 接口