KsCreateTopologyNode2, fonction (ks.h)

Article
02/26/2024

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

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 du 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 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 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 vers l’objet de diffusion en continu du noyau. En outre, la fonction Com (Component Object Model) CoInitialize doit être appelée avant que cette fonction ne soit appelée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
IRQL	PASSIVE_LEVEL

Voir aussi

Partager via