Freigeben über


KsStudio-Hilfsprogramm

Das Hilfsprogramm KsStudio ist ein Kernelstreamingtool, das zum Erstellen, Untersuchen und Testen von WDM KS-Filterdiagrammen in Windows verwendet werden kann. Eines der nützlichsten Features von KsStudio ist die Möglichkeit, eine grafische Darstellung eines Filterdiagramms zu erstellen, das sowohl die Anheftungsverbindungen zwischen Filtern als auch die internen Knoten der Filter anzeigt. Obwohl KsStudio in erster Linie für Audiofiltergraphen entwickelt wurde, kann es verwendet werden, um Graphen zu erstellen und zu untersuchen, die einen beliebigen Typ von WDM KS-Filter enthalten.

Zweck von KSStudio

Mehrere Klassen von Windows-Treibern, insbesondere solche im Multimediabereich, werden als AVStream-Filter (früher Kernel-Streaming oder KS) implementiert. Zu den Technologien, die auf der AVStream-Architektur basieren, gehören:

  • Audiotreiber, einschließlich USB- und PCI-Gerätetreibern, sowie Effekte und andere Zwischenfilter.

  • Videoaufnahme

KSStudio ist ein Tool, das dem AVStream-Filtertreiber direkten Zugriff auf den Filter in der Entwicklung ermöglicht. Seine Stärke liegt zum Teil in der Tatsache, dass es keine Multimedia-APIs wie DirectSound, MMSystem oder DirectShow verwendet und daher verwendet werden kann, um Probleme zu beheben, die mit diesen APIs auftreten.

KSStudio bietet die folgenden Features:

  • Aufzählung der Filterfactory

  • Filtern und Anheften der Instanziierung (einschließlich Grapherstellung)

  • Filtern und Anheften der Profilerstellung

  • Diagramme für die Filtertopologie

  • Anheften der Verbindung

  • Eigenschaftseinstellung und -abrufen

  • Ereignisermöglichung und Signalanzeige

  • Datenstreaming (nur Audio und vidcap)

  • Grundlegende Funktionstests

Installation des KsStudio-Hilfsprogramms (Ksstudio.exe)

Das Hilfsprogramm KsStudio (Ksstudio.exe) ist in den Softwaretools im Microsoft Windows Driver Kit (WDK) enthalten.

Laden Sie zum Installieren von KsStudio das WDK herunter, und führen Sie die WDK-Setupanwendung aus. Weitere Informationen finden Sie unter Herunterladen des Windows Driver Kit (WDK).

Setup installiert die plattformspezifischen Versionen von KsStudio.exe in den Unterverzeichnissen x86 und amd64 des Tools-Verzeichnisses.

KsStudio-Menülayout und -struktur

Screenshot der KSStream-Hilfsprogrammschnittstelle mit den Menübereichen 1, 2, 3 und 6 in der ersten Zeile, gefolgt von 4 und 5 in der unteren Zeile.

1) Filtern der Factoryansicht

In diesem Fenster werden die Filterfabriken angezeigt, die auf dem System installiert sind, organisiert nach KSCATEGORY. Hier werden auch "Testfilter" angezeigt. Weitere Informationen finden Sie unter Enumerationsoptionen und Filterfabriken. Die Filter factory View ist andockbar und kann in der Größe geändert werden.

2) Topologieansicht und 3) Objektdetailsesicht

Diese beiden Fenster zeigen Darstellungen aller instanziierten Filter und ihrer untergeordneten Objekte (Pinfactorys, Pins, Knoten und Verbindungen). Die Topologieansicht ist eine konzeptionelle Darstellung, die das Layout (Topologie) von Filtern und Diagrammen von Filtern betont. Es zeigt Verbindungen zwischen Pins, Datenpfade durch Filter und gibt den aktuellen Pinstatus an. Die Objektdetailsansicht ist eine hierarchische Textdarstellung, die Objektbeziehungen, aktuelle Werte von Eigenschaften sowie Anheft- und Ereigniszustände betont. Diese beiden Ansichten sind in dem Sinne kooperativ, dass durch Klicken auf ein Objekt in einer Ansicht die Darstellung des Objekts in der anderen ausgewählt wird. Die Objektdetailseansicht ist andockbar und kann in der Größe geändert werden.

4) Protokollierungsfenster

Alle Vorgänge, die für Kernelobjekte in KSStudio ausgeführt werden, erzeugen eine gewisse Menge an Protokollierung. Diese Protokollierung kann zu einem von drei Protokollierungszielen wechseln, nämlich zu (a) dem Protokollierungsfenster, (b) einer Protokolldatei und/oder (c) dem Debugger. Die Menge der Protokollierung kann für jede angegeben werden, indem Sie zum Menüelement View.Logging Options (Ansicht.Protokollierungsoptionen) navigieren. Das Protokollierungsfenster ist andockbar und kann in der Größe geändert werden.

5) KSMonitor IRP-Protokollansicht und 6) KSMonitor IRP-Statistikansicht

Diese beiden Fenster zeigen Details und Statistiken zu den IRPs an, die von allen angegebenen Filtern empfangen werden.

Weitere Informationen

KSStudio – Filter und Filterfabriken

KSStudio – Pins und Knoten

KSStudio – KSEigenschaften und Ereignisse

KSStudio – KS Monitor

KSStudio – Verwendungsbeispiele