BdaInitFilter, fonction (bdasup.h)
La fonction BdaInitFilter initialise le contexte de filtre BDA associé à une instance de filtre.
Syntaxe
NTSTATUS BdaInitFilter(
[in] PKSFILTER pKSFilter,
[in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);
Paramètres
[in] pKSFilter
Pointe vers le filtre dans lequel initialiser le contexte de filtre BDA.
[in] pBdaFilterTemplate
Pointe vers une structure BDA_FILTER_TEMPLATE qui décrit le modèle de filtre pour l’appareil BDA. Pour déterminer la topologie et configurer le filtre initialisé, le fournisseur de réseau utilise des informations référencées dans cette structure BDA_FILTER_TEMPLATE.
Valeur de retour
Retourne STATUS_SUCCESS ou un code d’erreur approprié.
Remarques
Un minidriver BDA appelle la fonction BdaInitFilter pour initialiser une instance d’un filtre à l’aide d’un modèle de filtre BDA spécifique et d’une fabrique de filtre créée précédemment via un appel à la fonction BdaCreateFilterFactory. Le minidriver BDA peut ensuite utiliser cette instance de filtre dans les appels à d’autres fonctions de prise en charge BDA, telles que BdaCreatePin.
Lorsqu’un minidriver BDA appelle BdaInitFilter, le pilote de prise en charge BDA (Bdasup.sys) crée son propre contexte de filtre BDA. Ce contexte de filtre BDA est masqué dans le minidriver BDA. Toutefois, si nécessaire, le pilote de prise en charge BDA peut accéder à ce contexte de filtre BDA. Le pilote de prise en charge BDA ajoute un pointeur à ce contexte de filtre BDA au conteneur d’objets pour l’objet KSFILTER associé. Lorsque l’objet KSFILTER associé est détruit, AVStream demande que le pilote de prise en charge BDA supprime ce contexte de filtre BDA du conteneur d’objets. De cette façon, le pilote de prise en charge BDA peut détruire ce contexte de filtre BDA sans nécessiter d’intervention du minidriver BDA.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible sur Microsoft Windows XP et les systèmes d’exploitation ultérieurs. Cette routine est disponible sur la plateforme Windows 2000 uniquement si Microsoft DirectX 9.0 et versions ultérieures sont installées sur cette plateforme. |
| plateforme cible | Bureau |
| d’en-tête | bdasup.h (include Bdasup.h) |
| bibliothèque | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |