MFGetTopoNodeCurrentType 函数 (mfidl.h)

获取与拓扑节点关联的流的媒体类型。

语法

HRESULT MFGetTopoNodeCurrentType(
        IMFTopologyNode *pNode,
        DWORD           dwStreamIndex,
        BOOL            fOutput,
  [out] IMFMediaType    **ppType
);

parameters

pNode

指向 IMFTopologyNode 接口的指针。

dwStreamIndex

要查询的流的标识符。 此参数的解释如下:

  • 转换节点:值是输入或输出流的从零开始的索引。
  • 所有其他节点类型:该值必须为零。

fOutput

如果为 TRUE,则函数获取输出类型。如果为 FALSE,则函数获取输入类型。 此参数的解释如下:

  • 输出节点:值必须为 TRUE
  • 源节点:该值必须为 FALSE
  • Tee 节点:忽略值。
  • 转换节点:如果值为 TRUE,则 dwStreamIndex 参数是输出流的索引。 否则, dwStreamIndex 是输入流的索引。

[out] ppType

接收指向 IMFMediaType 接口的指针。 调用方必须释放接口。

返回值

函数返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
MF_E_INVALIDSTREAMNUMBER
流索引无效。

注解

此函数从与拓扑节点关联的 对象获取实际媒体类型。 pNode 参数应指定属于完全解析拓扑的节点。 如果节点属于部分拓扑,则函数可能会失败。

Tee 节点没有要查询的关联对象。 对于 te 节点,函数获取节点的输入类型(如果可用)。 否则,如果没有可用的输入类型,该函数将获取节点的主输出流的媒体类型。 主输出流由 MF_TOPONODE_PRIMARYOUTPUT 属性标识。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 mfidl.h
Library Mf.lib
DLL Mf.dll

另请参阅

媒体基础函数