BdaCreateFilterFactory, fonction (bdasup.h)
La fonction BdaCreateFilterFactory ajoute le descripteur de filtre spécifié comme 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 du modèle peuvent ê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 de retour
Retourne STATUS_SUCCESS ou un code d’erreur approprié.
Remarques
Un minidriver BDA appelle la fonction BdaCreateFilterFactory pour ajouter une fabrique de filtres avec une topologie de modèle BDA associée à un appareil et inscrire toutes les structures de modèles statiques de la topologie avec la bibliothèque de support 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.Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible sur Microsoft Windows XP et les systèmes d’exploitation ultérieurs. |
| plateforme cible | Bureau |
| d’en-tête | bdasup.h (include Bdasup.h) |
| bibliothèque | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |