KsCreateTopologyNode-Funktion (ks.h)

Die KsCreateTopologyNode--Funktion erstellt ein Handle für eine Topologieknoteninstanz. Die Funktion kann nur bei PASSIVE_LEVELaufgerufen 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 Objekt an, auf dem der Knoten erstellt wird.

[in] NodeCreate

Gibt Parameter zum Erstellen von Topologieknoten an.

[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 STATUS_SUCCESSoder einen Fehler zurück, wenn kein Knoten erstellt werden kann.

Bemerkungen

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

Anforderungen

Siehe auch

ACCESS_MASK

KSNODE_CREATE