KsCreateTopologyNode2-Funktion (ks.h)

2025-02-07

Erstellt ein Handle für eine Topologieknoteninstanz.

Wird ab Windows 8 unterstützt.

Syntax

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

Parameter

[in] ParentHandle

Gibt das Handle für das übergeordnete Objekt an, auf dem der Knoten erstellt wird.

[in] NodeCreate

Eine KSNODE_CREATE Struktur, die den Satz von Informationen beschreibt, die zum Erstellen des Topologieknotenhandles verwendet werden.

[in] DesiredAccess

Gibt eine ACCESS_MASK an, die den gewünschten Zugriff auf das Objekt angibt. Dies ist in der Regel GENERIC_READ und/oder GENERIC_WRITE.

[out] NodeHandle

Speicherort für das Topologieknotenhandle.

Rückgabewert

Gibt NOERROR- zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

Dies ist eine neue Version der KsCreateTopologyNode--Funktion und verwendet den Gerätebroker, um das Handle für das Kernelstreamingobjekt zu erstellen. Darüber hinaus muss das Component Object Model (COM) CoInitialize-Funktion aufgerufen werden, bevor diese Funktion aufgerufen wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
IRQL-	PASSIVE_LEVEL

Siehe auch