Partager via


KsCreateTopologyNode, fonction (ks.h)

La fonction KsCreateTopologyNode crée un handle pour un nœud de topologie instance. La fonction ne peut être appelée qu’à PASSIVE_LEVEL.

Syntaxe

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

Paramètres

[in] ParentHandle

Spécifie le handle du parent sur lequel le nœud est créé.

[in] NodeCreate

Spécifie les paramètres de création de nœud de topologie.

[in] DesiredAccess

Spécifie une ACCESS_MASK indiquant l’accès souhaité à l’objet. Il s’agit généralement GENERIC_READ et/ou GENERIC_WRITE.

[out] NodeHandle

Emplacement du handle de nœud de topologie.

Valeur retournée

Retourne STATUS_SUCCESS ou une erreur si vous ne parvenez pas à créer un nœud.

Remarques

La structure KSNODE_CREATE décrit l’ensemble d’informations utilisées pour créer le handle de nœud.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête ks.h (inclure Ks.h)
Bibliothèque Ks.lib

Voir aussi

ACCESS_MASK

KSNODE_CREATE