IKsTopologyInfo::CreateNodeInstance method

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

Syntax


HRESULT CreateNodeInstance(
  [in]  DWORD  dwNodeId,
  [in]  REFIID iid,
  [out] 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 value

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

Return codeDescription
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

Minimum supported client

Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Vidcap.h

See also

Error and Success Codes
IKsTopologyInfo Interface

 

 

Show: