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. |