Klassifizierungen von MCI-Befehlen

MCI definiert vier Befehlsklassifizierungen: system, required, basic und extended. In der folgenden Liste werden diese Befehlsklassifizierungen beschrieben:

  • Systembefehle werden direkt von MCI und nicht vom Treiber verarbeitet.
  • Erforderliche Befehle werden vom Treiber verarbeitet. Alle MCI-Treiber müssen die erforderlichen Befehle und Flags unterstützen.
  • Grundlegende Befehle (oder optionale Befehle) werden von einigen Geräten verwendet. Wenn ein Gerät einen einfachen Befehl unterstützt, muss es einen definierten Satz von Flags für diesen Befehl unterstützen.
  • Erweiterte Befehle sind spezifisch für einen Gerätetyp oder Treiber. Erweiterte Befehle umfassen Befehle wie die Befehle put (MCI _ PUT) und where (MCI _ WHERE) für die Gerätetypen digitalvideo und overlay sowie Erweiterungen vorhandener Befehle (z. B. das Flag "stretch" des Status (MCI _ STATUS) für den Overlaygerätetyp).

Während system- und erforderliche Befehle die mindest erforderliche Befehlsmenge für jeden MCI-Treiber sind, werden einfache und erweiterte Befehle nicht von allen Treibern unterstützt. Ihre Anwendung kann immer system- und erforderliche Befehle und deren Flags verwenden. Wenn sie jedoch einen einfachen oder erweiterten Befehl oder ein Flag verwenden muss, sollte sie zuerst den Treiber mithilfe des Funktionsbefehls (MCI _ GETDEVCAPS) abfragen. In den folgenden Abschnitten werden die spezifischen Befehle in den einzelnen Kategorien zusammengefasst.

Systembefehle

MCI verarbeitet die folgenden Systembefehle direkt, anstatt sie an MCI-Geräte zu übergeben.

String Message BESCHREIBUNG
break _MCI-UNTERBRECHUNG Legt einen Halteschlüssel für ein MCI-Gerät fest.
Sysinfo MCI _ SYSINFO Gibt Informationen zu MCI-Geräten zurück.

Erforderliche Befehle

Alle MCI-Geräte unterstützen die folgenden erforderlichen Befehle.

String Message BESCHREIBUNG
Fähigkeit MCI _ GETDEVCAPS Ruft die Funktionen eines Geräts ab.
Schließen MCI _ CLOSE Schließt das Gerät.
Informationen _MCI-INFORMATIONEN Ruft Textinformationen von einem Gerät ab.
Öffnen MCI _ OPEN Initialisiert das Gerät.
status _MCI-STATUS Ruft Statusinformationen vom Gerät ab. Einige Flags dieses Befehls sind nicht erforderlich, sodass es sich auch um einen einfachen Befehl handelt.

Geräte müssen auch einen Standardsatz von Befehlsflags für die erforderlichen Befehle unterstützen.

Grundlegende Befehle

In der folgenden Liste sind die grundlegenden Befehle zusammengefasst. Die Verwendung dieser Befehle durch ein MCI-Gerät ist optional.

String Message BESCHREIBUNG
Laden MCI _ LOAD Lädt Daten aus einer Datei.
anhalten MCI _ PAUSE Beendet die Wiedergabe. Die Wiedergabe oder Aufzeichnung kann an der aktuellen Position fortgesetzt werden.
Spielen MCI _ PLAY Beginnt mit der Übertragung von Ausgabedaten.
Aufzeichnung MCI _ RECORD Beginnt mit der Aufzeichnung von Eingabedaten.
Fortsetzen MCI _ RESUME Setzt die Wiedergabe oder Aufzeichnung auf einem angehaltenen Gerät fort.
Speichern MCI _ SAVE Speichert Daten in einer Datenträgerdatei.
Suchen MCI _ SEEK Sucht vorwärts oder rückwärts.
Festgelegt MCI _ SET Legt den Betriebszustand des Geräts fest.
status MCI-STATUS Ruft Statusinformationen zum Gerät ab. Dies ist auch ein erforderlicher Befehl. Da einige flags nicht erforderlich sind, wird sie auch hier aufgeführt. (Die optionalen Elemente unterstützen Geräte, die lineare Medien mit identifizierbaren Positionen verwenden.)
Stoppen MCI _ STOP Beendet die Wiedergabe.

Wenn ein Treiber einen einfachen Befehl unterstützt, muss er auch einen Standardsatz von Flags für den Befehl unterstützen.

Erweiterte Befehle

Einige MCI-Geräte verfügen über zusätzliche Befehle, oder sie fügen vorhandenen Befehlen Flags hinzu. Während einige erweiterte Befehle nur für einen bestimmten Gerätetreiber gelten, gelten die meisten für alle Treiber eines bestimmten Gerätetyps. Beispielsweise erweitert der Befehlssatz für den Sequencer-Gerätetyp den Befehl set (MCI _ SET), um Zeitformate hinzuzufügen, die von DEN SEQUENCER-Sequenzern benötigt werden.

Sie sollten nicht davon ausgehen, dass das Gerät die erweiterten Befehle oder Flags unterstützt. Sie können den Befehl "capability" (MCI _ GETDEVCAPS)verwenden, um zu bestimmen, ob ein bestimmtes Feature unterstützt wird, und Ihre Anwendung sollte bereit sein, die Rückgabewerte "nicht unterstützter Befehl" oder "Nicht unterstützte Funktion" zu behandeln.

Die folgenden erweiterten Befehle sind mit den aufgeführten Gerätetypen verfügbar.

String Message Device types (Gerätetypen) Beschreibung
Konfigurieren MCI _ CONFIGURE digitalvideo Zeigt ein Konfigurationsdialogfeld an.
Hinweis MCI _ CUE digitalvideo, waveaudio Bereitet die Wiedergabe oder Aufzeichnung vor.
Löschen MCI _ DELETE Waveaudio Löscht ein Datensegment aus der Mediendatei.
Flucht MCI _ ESCAPE videodisc Sendet benutzerdefinierte Informationen an ein Gerät.
Einfrieren MCI _ FREEZE overlay Deaktiviert den Videoerwerb für den Framepuffer.
put MCI PUT digitalvideo, overlay Definiert die Quell-, Ziel- und Rahmenfenster.
Erkennen MCI _ REALIZE digitalvideo Weist das Gerät an, seine Palette in einem Gerätekontext des angezeigten Fensters auszuwählen und zu realisieren.
Setaudio MCI _ SETAUDIO digitalvideo Legt Audioparameter für Videos fest.
setvideo MCI _ SETVIDEO digitalvideo Legt Videoparameter fest.
Signal MCI _ SIGNAL digitalvideo Identifiziert eine angegebene Position mit einem Signal.
drehen MCI _ SPIN videodisc Startet das Drehen des Datenträgers oder beendet das Drehen des Datenträgers.
Schritt _MCI-SCHRITT digitalvideo, videodisc Gibt einen oder mehrere Frames vorwärts oder umgekehrt ab.
Auftauen MCI _ UNFREEZE overlay Ermöglicht dem Framepuffer das Erfassen von Videodaten.
aktualisieren MCI _ UPDATE digitalvideo Zieht den aktuellen Frame in den Gerätekontext um.
Wo MCI WHERE digitalvideo, overlay Erhält das Rechteck, das die Quelle, das Ziel oder den Framebereich angibt.
Fenster _MCI-FENSTER digitalvideo, overlay Steuert das Anzeigefenster.