BdaFilterFactoryUpdateCacheData, fonction (bdasup.h)

Article
02/22/2024

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

Syntaxe

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

Paramètres

[in] pFilterFactory

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

[in, optional] pFilterDescriptor

Pointe vers un KSFILTER_DESCRIPTOR facultatif pour lequel le cache de données d’épingle sera mis à jour. Si la valeur est NULL, le descripteur de pFilterFactory est utilisé à la place. Ce paramètre active la création dynamique d’une broche, c’est-à-dire la création d’une broche qui se produit une fois la routine de distribution de création d’un filtre terminée.

Valeur retournée

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

Remarques

Un minidriver BDA appelle la fonction BdaFilterFactoryUpdateCacheData pour mettre à jour le cache de données d’épingle pour toutes les broches spécifiées dans pFilterDescriptor. Dans cet appel, le minidriver BDA passe 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 a la valeur NULL, les informations mises en cache sont mises à jour pour toutes les fabriques de broches spécifiées au KSFILTER_DESCRIPTOR membre de pFilterFactory. Pour plus d’informations sur le cache de données d’épingle, consultez Mise en cache des informations d’épingle pour DirectShow.

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