IVMRMixerControl::SetZOrder 方法 (strmif.h)

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

方法 SetZOrder 以 Z 顺序设置此视频流的位置;较大的值越远。

语法

HRESULT SetZOrder(
  [in] DWORD dwStreamID,
  [in] DWORD dwZ
);

参数

[in] dwStreamID

指定输入流。

[in] dwZ

包含流在 Z 顺序中的位置的双字。

返回值

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

返回代码 说明
VFW_E_NOT_CONNECTED
引脚未连接。

注解

默认 Z 顺序是创建引脚的顺序。 仅当希望修改默认 Z 顺序时,才需要使用此方法。

要求

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

另请参阅

错误和成功代码

IVMRMixerControl 接口

IVMRMixerControl::GetZOrder

使用视频混合呈现器