IMFTopologyNode::GetTopoNodeID method (mfidl.h)

Article
02/22/2024

Retrieves the identifier of the node.

Syntax

HRESULT GetTopoNodeID(
  [out] TOPOID *pID
);

Parameters

[out] pID

Receives the identifier.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When a node is first created, it is assigned an identifier. Node identifiers are unique within a topology, but can be reused across several topologies. The topology loader uses the identifier to look up nodes in the previous topology, so that it can reuse objects from the previous topology.

To find a node in a topology by its identifier, call IMFTopology::GetNodeByID.

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