IMpeg2Demultiplexer::SetOutputPinMediaType 方法 (strmif.h)

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

方法 SetOutputPinMediaType 更新指定输出引脚的媒体类型。 (DirectX 9.0 及更高版本.)

语法

HRESULT SetOutputPinMediaType(
  [in] LPWSTR        pszPinName,
  [in] AM_MEDIA_TYPE *pMediaType
);

参数

[in] pszPinName

在对 CreateOutputPin 的调用中创建引脚时指定的引脚的友好名称。

[in] pMediaType

指向 AM_MEDIA_TYPE 结构的指针,该结构指定引脚的新媒体类型信息。

返回值

如果成功,则返回S_OK。 如果方法失败,它将返回 HRESULT 错误代码。

注解

可以随时使用新的媒体类型重新配置引脚。 如果不存在连接,则直接更新媒体类型。 如果引脚已连接,则调用的成功或失败将取决于下游输入引脚对指定媒体类型的接受或拒绝。

解多复用器筛选器不会以任何方式解释媒体类型。 它仅在连接协商期间由输出引脚使用。 它对媒体示例的内容没有影响。 当通过 IMPEG2PIDMap::MapPID 方法中的 MEDIA_SAMPLE_CONTENT 参数或通过 IMPEG2StreamIdMap::MapStreamId 调用中定义的值映射 PID 时,将定义媒体示例内容。

要求

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

另请参阅

错误和成功代码

IMpeg2Demultiplexer 接口