IMFTopologyNode::SetObject method (mfidl.h)

Article
02/22/2024

Sets the object associated with this node.

Syntax

HRESULT SetObject(
  [in] IUnknown *pObject
);

Parameters

[in] pObject

A pointer to the object's IUnknown interface. Use the value NULL to clear an object that was previous set.

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.

Remarks

All node types support this method, but the object pointer is not used by every node type.

Node type	Object pointer
Source node.	Not used.
Transform node.	IMFTransform or IMFActivate interface.
Output node	IMFStreamSink or IMFActivate interface.
Tee node.	Not used.

If the object supports IPersist, IPersistStorage, or IPersistPropertyBag, the method gets the object's CLSID and sets the MF_TOPONODE_TRANSFORM_OBJECTID attribute on the 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