KsFilterFactoryUpdateCacheData, fonction (ks.h)
La fonction KsFilterFactoryUpdateCacheData met à jour la clé de Registre FilterData et le cache Medium (un ensemble de clés de Registre) pour une fabrique de filtre donnée.
Syntaxe
KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY FilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);
Paramètres
[in] FilterFactory
KSFILTERFACTORY pour lequel mettre à jour FilterData et le cache medium dans le Registre.
[in, optional] FilterDescriptor
Une KSFILTER_DESCRIPTOR facultative pour laquelle la clé FilterData et le cache moyen seront mis à jour. Si la valeur est NULL, le descripteur de FilterFactory est utilisé à la place. Indiquez si la fabrique de filtre utilise des broches dynamiques et doit mettre à jour les informations pour les broches qui n’ont pas encore été instanciées.
Valeur retournée
KsFilterFactoryUpdateCacheData retourne STATUS_SUCCESS ou un code d’échec, indiquant si les informations de Registre pertinentes ont été correctement mises à jour. Il retourne STATUS_INVALID_PARAMETER si aucune interface d’appareil ne correspond aux catégories passées dans le descripteur de filtre.
Remarques
Cette fonction met à jour la clé FilterData et le cache moyen pour toutes les catégories spécifiées dans FilterDescriptor. Si FilterDescriptor a la valeur NULL, le filterdata et le cache moyen sont mis à jour pour toutes les catégories spécifiées dans le membre KSFILTER_DESCRIPTOR de FilterFactory.
KsRegisterFilterWithNoKSPins fournit des fonctionnalités similaires, mais ne doit pas être utilisé si deux instances de KSFILTER_DESCRIPTOR sous le même KSDEVICE sont inscrites dans la même catégorie et diffèrent uniquement dans le GUID de référence. Dans ce cas, KsRegisterFilterWithNoKSPins met à jour les données uniquement pour le premier, même si le deuxième peut avoir été spécifié.
N’utilisez pas cette routine à la place de KsRegisterFilterWithNoKSPins pour les filtres sans broche KS , comme les barres croisées de style analogique. Utilisez cette routine uniquement pour un filtre spécifique pour lequel le minidriver passe la fabrique de filtre correspondante.
En outre, KsRegisterFilterWithNoKSPins n’autorise qu’un seul support par broche inscrite. Cela peut ne pas suffire pour un minidriver BDA.
Pour plus d’informations, consultez Hiérarchie d’objets AVStream.
La fonction KsFilterFactoryUpdateCacheData ne peut être appelée que dans PASSIVE_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |