Fonction BdaInitFilter (bdasup.h)

La fonction BdaInitFilter initialise le contexte de filtre BDA associé à un 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 pour et configurer le filtre initialisé, le fournisseur de réseau utilise les informations référencées dans cette structure BDA_FILTER_TEMPLATE.

Valeur retournée

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 précédemment créée via un appel à la fonction BdaCreateFilterFactory. Le minidriver BDA peut ensuite utiliser ce filtre instance 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 vers ce contexte de filtre BDA vers le conteneur d’objets de 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 sac d’objets. De cette façon, le pilote de prise en charge BDA peut détruire ce contexte de filtre BDA sans nécessiter l’intervention du minidriver BDA.

Configuration requise

Voir aussi

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER