KsCreateTopologyNode2 function (ks.h)

Article
02/22/2024

Creates a handle to a topology node instance.

Supported starting in Windows 8.

Syntax

KSDDKAPI HRESULT KsCreateTopologyNode2(
  [in]  HANDLE         ParentHandle,
  [in]  PKSNODE_CREATE NodeCreate,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        NodeHandle
);

Parameters

[in] ParentHandle

Specifies the handle to the parent on which the node is created.

[in] NodeCreate

A KSNODE_CREATE structure that describes the set of information that is used to create the topology node handle.

[in] DesiredAccess

Specifies an ACCESS_MASK indicating the desired access to the object. This is typically GENERIC_READ and/or GENERIC_WRITE.

[out] NodeHandle

Location for the topology node handle.

Return value

Returns NOERROR if successful; otherwise, returns an error code.

Remarks

This is a new version of the KsCreateTopologyNode function and uses the device broker to create the handle to the kernel streaming object. In addition, the Component Object Model (COM) CoInitialize function must be called before this function is called.

Requirements

Requirement	Value
Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Target Platform	Universal
Header	ks.h (include Ks.h)
IRQL	PASSIVE_LEVEL