Expand Minimize

KsCreateTopologyNode2 function

Creates a handle to a topology node instance.

Supported starting in Windows 8.

Syntax


KSDDKAPI HRESULT WINAPI KsCreateTopologyNode2(
  _In_   HANDLE ParentHandle,
  _In_   PKSNODE_CREATE NodeCreate,
  _In_   ACCESS_MASK DesiredAccess,
  _Out_  PHANDLE NodeHandle
);

Parameters

ParentHandle [in]

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

NodeCreate [in]

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

DesiredAccess [in]

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

NodeHandle [out]

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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

Ks.h (include Ks.h)

IRQL

PASSIVE_LEVEL

See also

ACCESS_MASK
CoInitialize
KsCreateTopologyNode
KSNODE_CREATE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft