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

Voir aussi

KSPROPERTY

KSPROPERTY_BDA_NODE_DESCRIPTORS

KSPROPSETID_BdaTopology