BdaCreateFilterFactory, fonction (bdasup.h)
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 |