KsStudio - Filtres et filtres et fabriques
Cette rubrique décrit comment les filtres et les fabriques de filtres peuvent être affichés à l’aide de l’utilitaire KSStudio.
Les pilotes audio WDM (Microsoft Windows Driver Model) représentent un périphérique audio en tant que filtre KS, et ils représentent une mémoire tampon matérielle sur l’appareil sous la forme d’une broche sur le filtre. Pour plus d’informations, consultez Propriétés de filtre, d’épingle et de nœud.
Options d’énumération de la fabrique de filtreS KS
Une session dans KSStudio commence généralement par énumérer les fabriques de filtreS KS installées sur le système. Par défaut, une boîte de dialogue d’options d’énumération s’affiche à l’utilisateur au démarrage. Cette boîte de dialogue peut être appelée à tout moment après le démarrage via la barre de menus (View.Options...).
KSStudio énumère les filtres de deux façons :
API d’installation. Il s’agit de loin du moyen le plus courant et le plus utile de l’énumération de fabrique de filtres. Si une fabrique de filtres est correctement installée sur un système, elle est énumérable via une ou plusieurs catégories de filtres (par exemple, KSCATEGORY_AUDIO, KSCATEGORY_RENDER, etc.). Vous pouvez choisir les catégories à énumérer, en appuyant sur « Classes... » Bouton. Cela appelle une boîte de dialogue qui présente toutes les catégories actuellement déclarées dans KSMedia.h.
Explicitement par nom d’appareil. Si l’API d’installation n’énumère pas votre fabrique de filtre, mais que le pilote est installé (c’est-à-dire qu’il s’affiche sans erreur dans Gestionnaire de périphériques), vous pouvez peut-être instancier l’appareil explicitement par son nom. Pour ce faire, entrez le nom de l’appareil dans le contrôle d’édition « Filtres supplémentaires ». Cela peut être utile pour résoudre les problèmes d’énumération (par exemple, les erreurs INF).
KSStudio fournit également quelques « filtres de test », qui existent uniquement dans le programme KSStudio. Ces filtres de test peuvent être utilisés pour diffuser des données directement vers des filtres KS, ce qui peut être utile à des fins de résolution des problèmes.
Les fabriques de filtres installées énumérées par KSStudio sont affichées dans la vue Fabrique de filtre décrite dans l’utilitaire KSStudio.
Fabriques de filtres
Les fabriques de filtres énumérées sont affichées dans la vue Fabrique de filtre. Une fabrique de filtres est une facette d’un pilote WDM qui expose un nom de périphérique qui peut être passé pour CreateFile instancier un filtre (qui est un objet noyau). Pour chaque fabrique de filtre énumérée, KSStudio affiche une liste abrégée d’attributs récupérés à l’aide des API d’installation de Windows, sans instancier réellement le filtre.
L’attribut Nom de l’appareil est la chaîne transmise à CreateFile par KSStudio lorsque l’utilisateur choisit d’instancier le filtre.
Filtrer l’instanciation
Pour instancier un filtre, double-cliquez sur une fabrique de filtre dans la vue Fabrique de filtre (ou cliquez avec le bouton droit sur une fabrique et choisissez instancier). Si l’instanciation réussit, KSStudio interroge le filtre (via un barrage d’appels de propriété) et génère un profil à l’aide des valeurs obtenues. Ce profil est utilisé pour générer une représentation graphique du filtre instance dans la vue Topologie d’objet, qui est déduite des valeurs de propriété, et une représentation textuelle dans la vue Détails de l’objet qui montre les valeurs de propriété réelles obtenues.
Pour fermer un filtre, cliquez dessus avec le bouton droit et choisissez Fermer dans le menu contextuel.
Filtres de test
KSStudio est fourni avec plusieurs filtres de test ou pompes de données intégrés, ainsi nommés, car ils envoient les mémoires tampons de données qui sont remplies ou consommées par KS Filter Graph.
Pompe à fichiers wave. Ce filtre lit les fichiers .wav et envoie les données à des broches capables de consommer KSDATAFORMAT_TYPE_AUDIO données.
Pompe de fichiers MIDI. Ce filtre lit les fichiers .mid ou .rmi et envoie les données à des broches capables de consommer des données KSDATAFORMAT_TYPE_MUSIC.
Pompe de capture d’ondes. Ce filtre envoie des mémoires tampons vides aux broches capables de fournir des données KSDATAFORMAT_AUDIO. Les données sont affichées à l’aide d’un compteur VU.
Pompe de capture MIDI. Ce filtre envoie des mémoires tampons vides aux broches capables de fournir des données KSDATAFORMAT_MUSIC. Les données sont affichées dans la fenêtre de journalisation sous forme de messages MIDI bruts et traduits.
Pompe de flux duplex complet. Ce filtre envoie des mémoires tampons vides à une épingle KSDATAFLOW_IN, puis renvoie les données récupérées dans une broche KSDATAFLOW_OUT. Par exemple, vous pouvez utiliser cette pompe pour capturer des données PCM à partir d’une broche de micro et les renvoyer à une broche de rendu.