KsCreateTopologyNode2 function (ks.h)
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 |