BdaPropertyNodeDescriptors, fonction (bdasup.h)

La fonction BdaPropertyNodeDescriptors récupère une liste de nœuds dans une topologie de modèle.

Syntaxe

NTSTATUS BdaPropertyNodeDescriptors(
  [in]            PIRP               pIrp,
  [in]            PKSPROPERTY        pKSProperty,
  [out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);

Paramètres

[in] pIrp

Pointe vers l’IRP pour la demande de récupération de la liste des nœuds. Le minidriver BDA reçoit ce IRP avec la demande KSPROPERTY_BDA_NODE_DESCRIPTORS .

[in] pKSProperty

Pointe vers une structure KSPROPERTY qui décrit la propriété et le type de requête de la demande de propriété.

[out, optional] pNodeDescriptorProperty

Pointe vers un tableau qui reçoit la liste des GUID pour les nœuds dans une topologie de modèle.

Valeur retournée

Retourne STATUS_SUCCESS ou un code d’erreur approprié.

Remarques

Un minidriver BDA appelle la fonction BdaPropertyNodeDescriptors pour récupérer la liste des nœuds après que le minidriver a reçu une demande KSPROPERTY_BDA_NODE_DESCRIPTORS de la propriété KSPROPSETID_BdaTopology définie du fournisseur de réseau. La plupart des minidrivers BDA peuvent définir des tables dispatch et filter-automation afin que ces minidrivers distribuent la fonction BdaPropertyNodeDescriptors directement, sans intercepter cette requête à l’aide d’un get-handler interne (KStrGetPropertyHandler). Pour plus d’informations, consultez Définition de tables Automation et Détermination de la topologie d’appareil BDA .

Pour obtenir la liste des nœuds BDA qui peuvent être créés dans une topologie de modèle, consultez GUID de catégorie de nœud BDA.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible sur Microsoft Windows XP et les systèmes d’exploitation ultérieurs. Cette routine est disponible sur la plateforme Windows 2000 uniquement si Microsoft DirectX 9.0 et versions ultérieures est installé sur cette plateforme.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	bdasup.h (inclure Bdasup.h)
Bibliothèque	Bdasup.lib
IRQL	PASSIVE_LEVEL

Voir aussi

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology