BdaCreateFilterFactory, fonction (bdasup.h)

Article
02/22/2024

La fonction BdaCreateFilterFactory ajoute le descripteur de filtre spécifié en tant que fabrique de filtre à l’appareil spécifié et associe la fabrique de filtre à la topologie de modèle BDA spécifiée.

Syntaxe

NTSTATUS BdaCreateFilterFactory(
  [in] PKSDEVICE                 pKSDevice,
  [in] const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

Paramètres

[in] pKSDevice

Pointe vers l’appareil BDA auquel ajouter la fabrique de filtres avec la topologie de modèle BDA associée.

[in] pFilterDescriptor

Pointe vers une structure KSFILTER_DESCRIPTOR qui décrit un filtre pour l’appareil BDA. Notez que tous les types de broches et de nœuds de modèle ne peuvent pas être exposés en tant que fabriques de broches et de nœuds lorsque le filtre est initialisé pour la première fois.

[in] pBdaFilterTemplate

Pointe vers une structure BDA_FILTER_TEMPLATE qui décrit une topologie de modèle BDA.

Valeur retournée

Retourne STATUS_SUCCESS ou un code d’erreur approprié.

Remarques

Un minidriver BDA appelle la fonction BdaCreateFilterFactory pour ajouter une fabrique de filtre avec une topologie de modèle BDA associée à un appareil et inscrire toutes les structures de modèle statique de la topologie auprès de la bibliothèque de prise en charge BDA (BdaSup.sys). La bibliothèque de prise en charge BDA peut ensuite gérer les appels de méthode et de propriété suivants :

Si un minidriver BDA nécessite un pointeur vers la fabrique de filtre nouvellement créée (KSFILTERFACTORY), le minidriver doit appeler la fonction BdaCreateFilterFactoryEx à la place.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible sur Microsoft Windows XP et les systèmes d’exploitation ultérieurs.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	bdasup.h (inclure Bdasup.h)
Bibliothèque	Bdasup.lib
IRQL	PASSIVE_LEVEL