Fonction BdaCreateFilterFactoryEx (bdasup.h)

Article
02/26/2024

La fonction BdaCreateFilterFactoryEx 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 BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

Paramètres

[in] pKSDevice

Pointe vers l’appareil BDA auquel ajouter la fabrique de filtre 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 d’épingles et de nœuds de modèle ne peuvent pas être exposés en tant que fabriques de broches et de nœuds lors de la première initialisation du filtre.

[in] pBdaFilterTemplate

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

[out, optional] ppKSFilterFactory

Pointe vers une mémoire tampon qui reçoit un pointeur vers une structure KSFILTERFACTORY pour la fabrique de filtre nouvellement créée.

Valeur retournée

Retourne STATUS_SUCCESS ou un code d’erreur approprié.

Remarques

Un minidriver BDA appelle la fonction BdaCreateFilterFactoryEx pour ajouter une fabrique de filtres avec une topologie de modèle BDA associée à un appareil et pour 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 :

Un minidriver BDA appelle BdaCreateFilterFactoryEx plutôt que la fonction BdaCreateFilterFactory chaque fois qu’il nécessite un pointeur vers le KSFILTERFACTORY nouvellement créé. La fonction BdaCreateFilterFactory crée également une fabrique de filtres, mais ne la retourne pas à l’appelant. Le minidriver BDA nécessite un pointeur vers le KSFILTERFACTORY nouvellement créé si le minidriver doit appeler la fonction _KsEdit pour modifier KSFILTERFACTORY.

Configuration requise

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