IMFTopologyNode::GetInput method (mfidl.h)

Retrieves the node that is connected to a specified input stream on this node.

Syntax

HRESULT GetInput(
  [in]  DWORD           dwInputIndex,
  [out] IMFTopologyNode **ppUpstreamNode,
  [out] DWORD           *pdwOutputIndexOnUpstreamNode
);

Parameters

[in] dwInputIndex

Zero-based index of an input stream on this node.

[out] ppUpstreamNode

Receives a pointer to the IMFTopologyNode interface of the node that is connected to the specified input stream. The caller must release the interface.

[out] pdwOutputIndexOnUpstreamNode

Receives the index of the output stream that is connected to this node's input stream.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_INVALIDARG
The index is out of range.
MF_E_NOT_FOUND
The specified input stream is not connected to another node.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFTopologyNode

Topologies