IMFTopology::GetNodeByID method (mfidl.h)

Gets a node in the topology, specified by node identifier.

Syntax

HRESULT GetNodeByID(
  [in]  TOPOID          qwTopoNodeID,
  [out] IMFTopologyNode **ppNode
);

Parameters

[in] qwTopoNodeID

The identifier of the node to retrieve. To get a node's identifier, call IMFTopologyNode::GetTopoNodeID.

[out] ppNode

Receives a pointer to the node's IMFTopologyNode interface. The caller must release the interface.

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.
MF_E_NOT_FOUND
The topology does not contain a node with this identifier.

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

IMFTopology

TOPOID

Topologies