DirectShow Einführung / Einfache Wiedergabe

Was ist DirectShow?

Active Movie war der ursprüngliche Name für DirectShow. Jetzt, da DirectShow ein Teil von DirectX, seit Version 8, geworden ist, wird der Name ActiveMovie nicht mehr verwendet. Trotzdem heißt die Programmbibliothek, die wir verwenden werden "ActiveMovie control type library" (QUARTZ.DLL).

DirectShow ist eine Schnittstelle für qualitativ hochwertiges und schnelles Wiedergeben und Aufnehmen von Multimedialen Streaming Daten. Es unterstützt eine breite Front von Dateiformaten, unter anderem ASF, MPEG, AVI, MP3 und WAV Dateien. In DirectShow sind andere DirectX Technologien eingebaut, und es prüft und verwendet automatisch Beschleuniger-Hardware, falls vorhanden, läuft aber auch auf Systemen ohne Beschleuniger-Hardware.

DirectShow Initialisierung

Als erstes müsst ihr im Menü Projekt - Verweise einen Verweis auf die Programmbibliothek "ActiveMovie control type library" herstellen.

Der nächste Schritt ist die Deklaration der benötigten Objekte. Kopiert diesen Code in den Deklarationsteil eurer Anwendung:

OK... bevor wir aber neue Instanzen dieser Objekte erstellen können um eine Datei abzuspielen, müssen wir erst die alten Instanzen zerstören! Hier ist eine kleine Prozedur, die alle Objekte aus dem Speicher entfernt:

So, nun sind wir bereit, eine Multimedia Datei zu öffnen. Das funktioniert so:

Bevor ich beschreibe was hier eigentlich passiert, fragt ihr euch bestimmt, warum wir bei Fehlern einfach mit der nächsten Anweisung fortfahren. Nun, das ist einfach: Stellt euch vor, dass ihr eine Audio Datei öffnet. Unglücklicherweise haben Audio Dateien keine Video Daten (zumindest meine haben keine). Also gibt DirectShow einen Fehler aus, wenn wir versuchen das VideoWindow Objekt zu initialisieren.

Als erstes erstellen wir eine Instanz des FilterGraph Objekts für das jeweilige Dateiformat. Ein FilterGraph bestimmt wie Multimedia Dateien, die mit DirectShow geöffnet wurden, verarbeitet werden.

Dann erstellen und initialisieren wir unser BasicAudio Objekt, und stellen die anfängliche Lautstärke (volume) und Balance (balance) ein. Diese drei Zeilen könnten auch einen Fehler verursachen. Zum Beispiel, wenn ihr eine Videodatei ohne Audiodaten öffnet.

Im nächsten Schritt erstellen wir eine Instanz des VideoWindow Objekts, das wir für die Visualisierung von Video Dateien brauchen. Wie schon zuvor erwähnt, können diese Codezeilen aufgrund der gelieferten Daten Fehler verursachen! Wir setzen die WindowStyle Eigenschaft des VideoWindow Objekts auf WS_VISIBLE. Alle verfügbaren WindowStyle konstanten sind am Ende dieses Tutorials aufgelistet, und sind ausserdem in den API Text viewer Dateien, die mit Visual Basic ausgeliefert werden, aufgeführt. Die Top, Left, Width und Height Eigenschaften bestimmen die Größe des Ausgabefensters. Nun müssen wir noch einen sog. Besitzer (owner) bestimmen. Das ist das Ausgabeziel. In diesem Fall ist es ein einfaches PictureBox Steuerelement, und wir übergeben dessen WindowHandle.

Jetzt initialisieren wir das MediaEvent Objekt, mit dem wir die Wiedergabe steuern können. Wir werden es später dazu verwenden, den derzeitigen Wiedergabestatus zu erfahren.

Das letzte Objekt, dass wir initialisieren müssen, ist das MediaPosition Objekt. Das MediaPosition Objekt ermöglicht es uns die derzeitige Wiedergabeposition (current position) zu lesen und zu schreiben, die Wiedergabegeschwindigkeit (rate) zu lesen und zu schreiben und die Wiedergabedauer der Datei (duration) zu lesen. In dem oben gezeigten Code setzen wir die Wiedergabegeschwindigkeit auf 1, die eine normale Wiedergabegeschwindigkeit darstellt. Höhere Werte werden DirectShow die Datei schneller spielen lassen, niedrigere werden die Datei langsamer ablaufen lassen.

So, das war's mit der Initialisierung.

Wiedergeben der Datei

Wir werden mit der Wiedergabe der geladenen Datei anfangen:

Ja, es ist so einfach, wie es aussieht! :) Zuerst überprüfen wir, ob die derzeitige Wiedergabeposition am Ende der Datei ist. Falls das so ist, setzen wir die Wiedergabeposition an den Anfang zurück. Dann rufen wir einfach die Run Methode des MediaControl Objekts auf, und das war's!

Pausieren der Wiedergabe

Um die Wiedergabe zu unterbrechen, rufen wir einfach die Pause Methode des MediaControl Objekts auf:

Anhalten der Wiedergabe

Manchmal wollen einfältige Benutzer die Wiedergabe stoppen und von vorne beginnen. Na gut, dann werden wir sie lassen. :)

Vorwärts und Rückwärts suchen

Ein weiteres simples Feature, dass ein potentieller Benutzer gern verwenden würde :) Wir erreichen dies, indem wir einfach die CurrentPosition Eigenschaft des MediaPosition Objekts verändern. Dies WIRD den filter graph dazu veranlassen die Wiedergabe zu unterbrechen (pause), die neue Position einzustellen und dann die Wiedergabe fortzusetzen (run). Aber diese Methode hat sich als schnell genug erwiesen, um sie in Echtzeit zu verwenden .

Um rückwärts zu suchen, brauchen wir nur einen negativen Wert für Amount zu übergeben. Nun, da wir dem Benutzer ein derart mächtiges Werkzeug zur Verfügung stellen, müssen wir auch genau auf seine Eingaben achten! :) Denn, wenn er eine Position vor dem Start oder hinter dem Ende der Datei sucht, müssen wir diesen Fehler korrigieren.

Das MediaEvent Objekt

Syntax:

Wir werden nur die WaitForCompletion Methode dieses Objekts verwenden. Diese Methode akzeptiert zwei Variablen als Argumente. Das erste Argument legt fest, nach welchem Zeitraum die Methode die Kontrolle an uns zurückgeben soll, und das zweite Argument wird von der Methode selbst gesetzt und enthält den sog. event completion code. Wenn wir nun 0 oder eine höhere Zahl als msTimeout übergeben, dann wird die Methode die Kontrolle erst an uns zurückgeben, wenn dieses Zeitlimit erreicht (0 = sofort) oder wenn das Dateiende erreicht wurde, was auch immer zuerst eintritt. Wenn das Zeitlimit erreicht wurde, dann wird der EvCode gleich 0 (null) sein und der Laufzeit Fehler 287 wird eintreten ("Application-defined or object-defined error"). Wir können diesen Fehler so ignorieren:

Also für alles andere ausser -1, dass als msTimeout übergeben wird, müssen wir den Fehler ignorieren und den EvCode überprüfen. 0 (null) bedeutet, dass DirectShow die Datei immer noch wiedergibt, 1 oder höher bedeutet, dass das Dateiende erreicht wurde. Wenn wir -1 als msTimeout übergeben, dann wird DirectShow uns die Kontrolle erst wiedergeben, sobald das Dateiende erreicht wurde. Aber in der Zwischenzeit reagiert unsere Anwendung auf keinerlei Benutzereingaben!

Das war's!

Das war der ganze grundlegende Kram, den ihr wissen müsst! Mit diesem Code seit ihr in der Lage jede Datei abzuspielen, die ihr sonst mit eurem Standart Player abspielt! Falls ihr eine Datei abspielen wollt, die nicht zu DirectShows normalen Dateiformaten gehört, dann müsst ihr nur den entsprechenden codec (COder/DECoder) für dieses Format installieren.

Ich habe ausserdem eine Beispielanwendung erstellt, die den oben gezeigten Code verwendet. Ladet sie hier herunter. (Die Kommentare in dieser Beispielanwendung sind alle englisch!)

Ich hoffe ihr habt unsere Zeit zusammen genossen. Bis zum nächsten Mal! 

Und noch viel Spaß beim coden von coolen Multimedia Spielen und Anwendungen mit DirectShow. 

-Paladin

Anhang

Alle WindowStyle konstanten... Ich schätze ihr braucht eh nur WS_VISIBLE, aber ich hab sie trotzdem alle aufgelistet: