Freigeben über


KsCreateTopologyNode-Funktion (ks.h)

Die KsCreateTopologyNode-Funktion erstellt ein Handle für einen Topologieknoten instance. Die Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.

Syntax

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

Parameter

[in] ParentHandle

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

[in] NodeCreate

Gibt Topologieknotenerstellungsparameter an.

[in] DesiredAccess

Gibt einen ACCESS_MASK an, der 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 STATUS_SUCCESS oder einen Fehler zurück, wenn kein Knoten erstellt werden kann.

Hinweise

Die KSNODE_CREATE-Struktur beschreibt den Satz von Informationen, die zum Erstellen des Knotenhandles verwendet werden.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header ks.h (einschließlich Ks.h)
Bibliothek Ks.lib

Weitere Informationen

ACCESS_MASK

KSNODE_CREATE