Klassifizierungen von MCI-Befehlen

[Das feature, das dieser Seite zugeordnet ist, MCI-ist ein Legacyfeature. Es wurde von MediaPlayerersetzt. MediaPlayer- wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code MediaPlayer- anstelle MCI-verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben werden.]

MCI definiert vier Befehlsklassifizierungen: System, erforderlich, einfach und erweitert. In der folgenden Liste werden die folgenden Befehlsklassifizierungen beschrieben:

• Systembefehle von MCI direkt und nicht vom Treiber behandelt werden.
• Erforderliche Befehle werden vom Treiber behandelt. Alle MCI-Treiber müssen die erforderlichen Befehle und Flags unterstützen.
• Standardbefehle (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.
• erweiterten Befehle spezifisch für einen Gerätetyp oder Treiber sind. Zu den erweiterten Befehlen gehören Befehle wie die (MCI_PUT) und , wobei (MCI_WHERE) Befehle für die digitalvideo- und Overlay- Gerätetypen sowie Erweiterungen für vorhandene Befehle (z. B. das Flag "Stretch" des Status (MCI_STATUS) für den Überlagerungsgerätetyp).

System- und erforderliche Befehle sind zwar die Mindestbefehle für jeden MCI-Treiber, aber grundlegende und erweiterte Befehle werden von allen Treibern nicht unterstützt. Ihre Anwendung kann immer system- und erforderliche Befehle und deren Flags verwenden. Wenn sie jedoch einen einfachen oder erweiterten Befehl oder eine erweiterte Kennzeichnung verwenden muss, sollte sie zuerst den Treiber mithilfe des befehls -Funktion (MCI_GETDEVCAPS) abfragen. In den folgenden Abschnitten werden die spezifischen Befehle in jeder Kategorie zusammengefasst.

Systembefehle

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

Schnur	Nachricht	Beschreibung
	MCI_BREAK	Legt einen Umbruchschlü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.

Schnur	Nachricht	Beschreibung
-Funktion	MCI_GETDEVCAPS	Ruft die Funktionen eines Geräts ab.
schließen	MCI_CLOSE	Schließt das Gerät.
Informationen	MCI_INFO	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, daher ist es auch ein einfacher Befehl.

 

Geräte müssen auch einen Standardsatz von Befehlskennzeichnungen 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.

Schnur	Nachricht	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.
wiedergeben	MCI_PLAY	Beginnt mit der Übertragung von Ausgabedaten.
Datensatz	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.
festlegen	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 seiner Flags nicht erforderlich sind, wird sie auch hier aufgeführt. (Die optionalen Elemente unterstützen Geräte, die lineare Medien mit identifizierbaren Positionen verwenden.)
beenden	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 fügen Flags zu vorhandenen Befehlen hinzu. Einige erweiterte Befehle gelten zwar nur für einen bestimmten Gerätetreiber, die meisten gelten jedoch für alle Treiber eines bestimmten Gerätetyps. Beispielsweise erweitert der Befehlssatz für den Sequencer Gerätetyp den Set-Befehl (MCI_SET) um Zeitformate hinzuzufügen, die von MIDI-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 Funktion (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.

Schnur	Nachricht	Gerätetypen	Beschreibung
konfigurieren	MCI_CONFIGURE	Digitalvideo	Zeigt ein Konfigurationsdialogfeld an.
	MCI_CUE	Digitalvideo, waveaudio	Bereitet sich auf die Wiedergabe oder Aufzeichnung vor.
löschen	MCI_DELETE	waveaudio	Löscht ein Datensegment aus der Mediendatei.
Escape-	MCI_ESCAPE	videodisc	Sendet benutzerdefinierte Informationen an ein Gerät.
fixieren	MCI_FREEZE	Overlay	Deaktiviert die Videoaufnahme für den Framepuffer.
	MCI PUT	Digitalvideo, Overlay	Definiert die Quell-, Ziel- und Framefenster.
	MCI_REALIZE	Digitalvideo	Weist das Gerät an, seine Palette in einem Gerätekontext des angezeigten Fensters auszuwählen und zu erkennen.
setaudio-	MCI_ SETAUDIO-	Digitalvideo	Legt Audioparameter für Video fest.
setvideo-	MCI_ SETVIDEO-	Digitalvideo	Legt Videoparameter fest.
Signal	MCI_SIGNAL	Digitalvideo	Identifiziert eine angegebene Position mit einem Signal.
Drehen	MCI_SPIN	videodisc	Startet die Scheibe, die sich dreht oder stoppt, dass die Scheibe sich dreht.
Schritt	MCI_STEP	digitalvideo, videodisc	Führt die Wiedergabe eines oder mehrerer Frames vorwärts oder umgekehrt durch.
aufheben der Fixierung	MCI_UNFREEZE	Overlay	Ermöglicht dem Framepuffer das Abrufen von Videodaten.
update	MCI_UPDATE	Digitalvideo	Überschreibt den aktuellen Frame in den Gerätekontext.
wo	MCI WHERE-	Digitalvideo, Overlay	Ruft das Rechteck ab, das den Quell-, Ziel- oder Framebereich angibt.
Fenster	MCI_WINDOW	Digitalvideo, Overlay	Steuert das Anzeigefenster.