KsCreateTopologyNode function (ks.h)

Article
02/22/2024

The KsCreateTopologyNode function creates a handle to a topology node instance. The function can only be called at PASSIVE_LEVEL.

Syntax

KSDDKAPI NTSTATUS KsCreateTopologyNode(
  [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

Specifies topology node create parameters.

[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 STATUS_SUCCESS, or an error if unable to create a node.

Remarks

The KSNODE_CREATE structure describes the set of information used to create the node handle.

Requirements

Requirement	Value
Target Platform	Universal
Header	ks.h (include Ks.h)
Library	Ks.lib