Méthode IKsTopology ::CreateNodeInstance (ksproxy.h)

La méthode CreateNodeInstance demande un objet de filtre KS pour ouvrir un objet de nœud de topologie.

Syntaxe

HRESULT CreateNodeInstance(
  [in]           ULONG       NodeId,
  [in]           ULONG       Flags,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] IUnknown    *UnkOuter,
  [in]           REFGUID     InterfaceId,
  [out]          LPVOID      *Interface
);

Paramètres

[in] NodeId

Identificateur de l’objet de nœud de topologie à ouvrir.

[in] Flags

Masque de bits énumérant le type d’objet de nœud de topologie. Aucun indicateur n’est actuellement défini.

[in] DesiredAccess

Masque de bits ACCESS_MASK spécifiant le type d’accès requis par l’appelant à l’objet de nœud de topologie. Consultez ZwCreateFile pour obtenir une description de chaque valeur de droit d’accès.

[in, optional] UnkOuter

Pointeur vers une interface IUnknown qui prend en charge l’interface de nœud de topologie.

[in] InterfaceId

Identificateur de l’interface de nœud de topologie demandée.

[out] Interface

Pointeur vers une variable qui reçoit le pointeur d’interface demandé dans InterfaceId. Une fois le retour réussi, *Interface contient le pointeur d’interface demandé vers l’objet . Si l’objet ne prend pas en charge l’interface spécifiée dans InterfaceId, *Interface a la valeur NULL.

Valeur retournée

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

Configuration requise

Condition requise	Valeur
Plateforme cible	DesktopMobile
En-tête	ksproxy.h (inclure Ksproxy.h)

Voir aussi

ACCESS_MASK

IKsTopology

ZwCreateFile