IKsTopologyInfo::CreateNodeInstance

Microsoft DirectShow 9.0

This topic applies to Windows XP Service Pack 2 and later.

The CreateNodeInstance method creates a COM object that represents a node in the filter.

Syntax

  HRESULT CreateNodeInstance(
  DWORD  dwNodeId,
  REFIID  iid,
  void**  ppvObject
);

Parameters

dwNodeId

[in] Index of the node to create. To find the number of nodes, call the IKsTopologyInfo::get_NumNodes method.

iid

[in] Interface identifier (IID) of the interface to return.

ppvObject

[out] Receives a pointer to the requested interface on the node object. The caller must release the interface.

Return Values

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

Node objects expose the IKsControl interface. You can use this interface to enumerate and access the node's property sets.

Requirements

Header: Include Vidcap.h.

Library: None.

See Also

Additional resources