BdaCreateFilterFactoryEx, fonction (bdasup.h)
La fonction BdaCreateFilterFactoryEx 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 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 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.
[out, optional] ppKSFilterFactory
Pointe vers une mémoire tampon qui reçoit un pointeur vers une structure KSFILTERFACTORY pour la fabrique de filtres nouvellement créée.
Valeur de retour
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 inscrire toutes les structures de modèle statique 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 :
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 filtre, 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.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 |