BdaPropertyTemplateConnections, fonction (bdasup.h)

Article
02/06/2025

La fonction BdaPropertyTemplateConnections récupère une liste de connexions qui décrivent comment les types de broches et les types de nœuds sont connectés dans une topologie de modèle.

Syntaxe

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

Paramètres

[in] pIrp

Pointe vers l’IRP de la demande pour récupérer la liste des connexions. Le minidriver BDA reçoit cet IRP avec la demande de KSPROPERTY_BDA_TEMPLATE_CONNECTIONS.

[in] pKSProperty

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

[out, optional] pConnectionProperty

Pointe vers un tableau qui reçoit la liste des structures KSTOPOLOGY_CONNECTION qui décrivent les connexions dans une topologie de modèle.

Valeur de retour

Retourne STATUS_SUCCESS ou un code d’erreur approprié.

Remarques

Un minidriver BDA appelle la fonction BdaPropertyTemplateConnections pour récupérer la liste des connexions de modèle une fois que le minidriver reçoit une requête KSPROPERTY_BDA_TEMPLATE_CONNECTIONS de la propriété KSPROPSETID_BdaTopology définie à partir du fournisseur réseau. La plupart des minidrivers BDA peuvent définir des tables de répartition et d’automatisation des filtres afin que ces minidrivers distribuent directement les BdaPropertyTemplateConnections fonction, sans intercepter cette requête à l’aide d’un gestionnaire get-handler interne (KStrGetPropertyHandler). Pour plus d’informations, consultez Définition des tables Automation et détermination de la topologie des appareils BDA.

Le minidriver BDA a fourni une liste de connexions à la bibliothèque de prise en charge BDA dans un tableau de structures KSTOPOLOGY_CONNECTION lorsque le minidriver BDA a passé le modèle de filtre BDA (BDA_FILTER_TEMPLATE) dans BdaCreateFilterFactory et appels de fonction BdaInitFilter. Ce tableau est une représentation de toutes les connexions possibles entre les types de nœud et de broche qui peuvent être effectuées dans le filtre ou entre le filtre et les filtres adjacents. La fonction BdaPropertyTemplateConnections retourne ce tableau.