KsCreateTopologyNode2, fonction (ks.h)

Article
02/07/2025

Crée un handle vers une instance de nœud de topologie.

Prise en charge à partir de Windows 8.

Syntaxe

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

Paramètres

[in] ParentHandle

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

[in] NodeCreate

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

[in] DesiredAccess

Spécifie un ACCESS_MASK indiquant l’accès souhaité à l’objet. Cela est généralement GENERIC_READ et/ou GENERIC_WRITE.

[out] NodeHandle

Emplacement du handle de nœud de topologie.

Valeur de retour

Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.

Remarques

Il s’agit d’une nouvelle version de la fonction KsCreateTopologyNode et utilise le répartiteur d’appareils pour créer le handle sur l’objet de diffusion en continu du noyau. En outre, le modèle objet de composant (COM) CoInitialize fonction doit être appelé avant que cette fonction soit appelée.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
IRQL	PASSIVE_LEVEL

Voir aussi

Partager via