BdaFilterFactoryUpdateCacheData, fonction (bdasup.h)

Article
02/06/2025

La fonction BdaFilterFactoryUpdateCacheData met à jour le cache de données pin pour une instance d’un filtre.

Syntaxe

NTSTATUS BdaFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          pFilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);

Paramètres

[in] pFilterFactory

Pointe vers la KSFILTERFACTORY pour laquelle mettre à jour le cache de données d’épingle.

[in, optional] pFilterDescriptor

Pointe vers une KSFILTER_DESCRIPTOR facultative pour laquelle le cache de données pin sera mis à jour. Si NULL, pFilterFactory's descripteur’s est utilisé à la place. Ce paramètre active la création de broches dynamiques, autrement dit, la création d’épingles qui se produit après la fin de la routine de distribution de création d’un filtre.

Valeur de retour

Retourne STATUS_SUCCESS ou un code d’erreur approprié. Retourne STATUS_INVALID_PARAMETER si aucune interface d’appareil n’est trouvée qui correspond aux catégories passées dans le descripteur de filtre.

Remarques

Un minidriver BDA appelle la fonction BdaFilterFactoryUpdateCacheData pour mettre à jour le cache de données pin pour toutes les broches spécifiées à pFilterDescriptor. Dans cet appel, le minidriver BDA transmet généralement le membre pFilterDescriptor d’une structure BDA_FILTER_TEMPLATE qui décrit la topologie de modèle pour le filtre BDA à pFilterDescriptor. Si pFilterDescriptor est NULL, les informations mises en cache sont mises à jour pour toutes les fabriques de broches spécifiées à membre KSFILTER_DESCRIPTOR pFilterFactory. Pour plus d’informations sur le cache de données de broche, consultez Informations de mise en cache pour DirectShow.

La fonction KsRegisterFilterWithNoKSPins fournit des fonctionnalités similaires, mais ne permet qu’un support par broche inscrite. Cela peut ne pas suffire pour un minidriver BDA.