KsStudio – Filter und Fabriken
In diesem Thema wird beschrieben, wie Filter und Filterfabriken mithilfe des KSStudio-Hilfsprogramms angezeigt werden können.
WdM-Audiotreiber (Microsoft Windows Driver Model) stellen ein Audiogerät als KS-Filter dar und stellen einen Hardwarepuffer auf dem Gerät als Anheftung am Filter dar. Weitere Informationen finden Sie unter Filter-, Pin- und Node-Eigenschaften.
KS Filter Factory-Enumerationsoptionen
Eine Sitzung in KSStudio beginnt in der Regel mit dem Auflisten der auf dem System installierten KS-Filterfabriken. Standardmäßig wird dem Benutzer beim Start ein Dialogfeld mit Enumerationsoptionen angezeigt. Dieses Dialogfeld kann nach dem Start jederzeit über die Menüleiste (Ansicht.Optionen...) aufgerufen werden.
Es gibt zwei Möglichkeiten, mit denen KSStudio Filter aufzählt:
Setup-API. Dies ist bei weitem das gängigste und nützlichste Mittel der Filter factory-Enumeration. Wenn eine Filter factory ordnungsgemäß auf einem System installiert ist, kann sie über eine oder mehrere Filterkategorien aufgezählt werden (z. B. KSCATEGORY_AUDIO, KSCATEGORY_RENDER usw.). Sie können auswählen, welche Kategorien aufgelistet werden sollen, indem Sie auf "Klassen..." klicken. Schaltfläche. Dadurch wird ein Dialogfeld aufgerufen, in dem alle kategorien angezeigt werden, die derzeit in KSMedia.h deklariert sind.
Explizit nach Gerätename. Wenn die Setup-API Ihre Filter factory nicht aufzählt, aber der Treiber installiert ist (d. h. er wird ohne Fehler in Geräte-Manager angezeigt), können Sie das Gerät möglicherweise explizit nach Namen instanziieren. Dazu geben Sie den Gerätenamen im Bearbeitungssteuerelement "Zusätzliche Filter" ein. Dies kann nützlich sein, um Probleme beim Beheben von Enumerationsproblemen (z. B. INF-Fehler) zu beheben.
KSStudio bietet auch einige "Testfilter", die nur im KSStudio-Programm vorhanden sind. Diese Testfilter können verwendet werden, um Daten direkt an KS-Filter zu streamen, was für Problembehandlungszwecke nützlich sein kann.
Die installierten Filterfabriken, die KSStudio aufzählt, werden in der Filter Factory-Ansicht angezeigt, die im KSStudio-Hilfsprogramm erläutert wird.
Filterfabriken
Aufgezählte Filterfabriken werden in der Filter Factory-Ansicht angezeigt. Eine Filter factory ist ein Facet eines WDM-Treibers, der einen Gerätenamen verfügbar macht, an den möglicherweise übergeben wird, um einen Filter (bei dem es sich um CreateFile ein Kernelobjekt handelt) zu instanziieren. Für jede aufgezählte Filter factory zeigt KSStudio eine gekürzte Liste von Attributen an, die mithilfe der Windows Setup-APIs abgerufen werden, ohne den Filter tatsächlich instanziieren zu müssen.
Das Device Name-Attribut ist die Zeichenfolge, die CreateFile von KSStudio übergeben wird, wenn der Benutzer den Filter instanziiert.
Filterinstanziation
Um einen Filter zu instanziieren, doppelklicken Sie in der Ansicht Filter Factory auf eine Filterfactory (oder klicken Sie mit der rechten Maustaste auf eine Fabrik, und wählen Sie Instanziieren aus). Wenn die Instanziierung erfolgreich ist, fragt KSStudio den Filter ab (über eine Reihe von Eigenschaftsaufrufen) und erstellt ein Profil unter Verwendung der abgerufenen Werte. Dieses Profil wird verwendet, um eine grafische Darstellung des Filter instance in der Objekttopologieansicht zu generieren, die aus den Eigenschaftenwerten abgeleitet wird, und eine Textdarstellung in der Objektdetailsesicht, die die tatsächlich abgerufenen Eigenschaftswerte anzeigt.
Um einen Filter zu schließen, klicken Sie mit der rechten Maustaste darauf, und wählen Sie im Popupmenü Schließen aus.
Testfilter
KSStudio verfügt über mehrere integrierte Testfilter oder Datenpumpen, die so genannt werden, weil sie die Datenpuffer übermitteln, die entweder vom KS-Filterdiagramm gefüllt oder verbraucht werden.
Wave File Pump. Dieser Filter liest WAV-Dateien und übermittelt die Daten an Pins, die KSDATAFORMAT_TYPE_AUDIO Daten nutzen können.
MIDI-Dateipumpe. Dieser Filter liest MID- oder RMI-Dateien und übermittelt die Daten an Pins, die KSDATAFORMAT_TYPE_MUSIC Daten nutzen können.
Wellenerfassungspumpe. Dieser Filter sendet leere Puffer an Pins, die KSDATAFORMAT_AUDIO Daten bereitstellen können. Die Daten werden mithilfe eines VU-Messgeräts angezeigt.
MIDI Capture Pump. Dieser Filter sendet leere Puffer an Pins, die KSDATAFORMAT_MUSIC Daten bereitstellen können. Die Daten werden im Protokollierungsfenster als unformatierte und übersetzte MIDI-Nachrichten angezeigt.
Vollduplex-Streampumpe. Dieser Filter übergibt leere Puffer an eine KSDATAFLOW_IN Pin und übermittelt dann die abgerufenen Daten erneut an einen KSDATAFLOW_OUT Pin. Beispielsweise kann man diese Pumpe verwenden, um PCM-Daten von einem Mikrofonnadel zu erfassen und sie erneut an einen Rendernadel zu übermitteln.