KsFilterFactoryUpdateCacheData, fonction (ks.h)
La fonction KsFilterFactoryUpdateCacheData met à jour la clé de Registre FilterData et le cache moyen (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
Le KSFILTERFACTORY pour lequel mettre à jour le cache FilterData et Medium dans le Registre.
[in, optional] FilterDescriptor
Une KSFILTER_DESCRIPTOR facultative pour laquelle la clé FilterData et le cache moyen seront mis à jour. Si NULL, le descripteur de FilterFactoryest utilisé à la place. Indiquez si la fabrique de filtre utilise des broches dynamiques et doit mettre à jour des informations pour les broches qui n’ont pas encore été instanciées.
Valeur de retour
KsFilterFactoryUpdateCacheData retourne STATUS_SUCCESS ou un code d’échec, indiquant si les informations de Registre pertinentes ont été correctement mises à jour. Elle 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
Cette fonction met à jour la clé FilterData et le cache moyen pour toutes les catégories spécifiées dans FilterDescriptor. Si FilterDescriptor est NULL, le cache FilterData et Medium est mis à jour pour toutes les catégories spécifiées dans membreKSFILTER_DESCRIPTOR FilterFactory.
KsRegisterFilterWithNoKSPins fournit des fonctionnalités similaires, mais ne doit pas être utilisée 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 la première, même si la seconde peut avoir été spécifiée.
N’utilisez pas cette routine à la place de KsRegisterFilterWithNoKSPins pour les filtres sans broches 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 autorise uniquement un 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |