Fonction BdaPropertyTemplateConnections (bdasup.h)

Article
02/26/2024

La fonction BdaPropertyTemplateConnections récupère une liste de connexions qui décrivent comment les types de broches et 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 pour la demande de récupération de la liste des connexions. Le minidriver BDA reçoit cette IRP avec la demande 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 demande 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 retournée

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 après que le minidriver a reçu une demande KSPROPERTY_BDA_TEMPLATE_CONNECTIONS de la KSPROPSETID_BdaTopology propriété définie 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 mini-disques distribuent directement le fonctionnement BdaPropertyTemplateConnections , sans intercepter cette requête à l’aide d’un gestionnaire get-handler interne (KStrGetPropertyHandler). Pour plus d’informations, consultez Définition de 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 les appels de fonction BdaCreateFilterFactory et BdaInitFilter . Ce tableau est une représentation de toutes les connexions possibles entre les types de nœuds et de broches qui peuvent être effectuées dans le filtre ou entre le filtre et les filtres adjacents. La fonction BdaPropertyTemplateConnections retourne ce tableau.