Makros und Meldungen für MCI-Funktionen

Die meisten MCI-Anwendungen verwenden die Funktionen mciSendString und mciSendCommand dutzendfach. MCI bietet einige weitere nützliche Funktionen, die Ihre Anwendung seltener verwenden wird.

Die für die meisten MCI-Befehle erforderliche Geräte-ID wird in der Regel in einem Aufruf des open-Befehls (MCI _ OPEN) abgerufen. Wenn Sie eine Geräte-ID benötigen, das Gerät jedoch nicht öffnen möchten , z. B. wenn Sie die Funktionen des Geräts abfragen möchten, bevor Sie eine andere Aktion ausführen, können Sie die mciGetDeviceID-Funktion aufrufen.

Mit der mciGetCreatorTask-Funktion kann Ihre Anwendung einen Gerätebezeichner verwenden, um ein Handle für den Task abzurufen, der diesen Bezeichner erstellt hat.

Sie können die Funktionen mciGetYieldProc und mciSetYieldProc verwenden, um die Adresse der Rückruffunktion zu zuweisen und abzurufen, die dem Wait-Flag (MCI WAIT) zugeordnet _ ist.

Die mciGetErrorString-Funktion ruft eine Zeichenfolge ab, die einen MCI-Fehlerwert beschreibt. Jede Zeichenfolge, die MCI zurückgibt, ob Daten oder eine Fehlerbeschreibung, ist maximal 128 Zeichen lang. Dialogfeldfelder, die kleiner als 128 Zeichen sind, schneiden die längeren Zeichenfolgen ab, die von MCI zurückgegeben werden. Weitere Informationen zu diesen Zeichenfolgen finden Sie unter MCIERR-Rückgabewerte.

Die MCI-Makros sind Tools, mit denen Sie Werte erstellen und disassemblieren können, die Zeitformate angeben. Diese Zeitformate werden in vielen MCI-Befehlen verwendet. Die Von den Makros umgesetzten Formate sind Stunden/Minuten/Sekunden (HMS), Minuten/Sekunden/Frames (MSF) und Tracks/Minuten/Sekunden/Frames (TMSF). In der folgenden Tabelle sind die Makros und ihre Beschreibungen aufgeführt.

Makro Beschreibung
MCI _ HMS _ HOUR Ruft die Stundenkomponente aus einem HMS-Wert ab.
MCI _ HMS _ MINUTE Ruft die Minutenkomponente aus einem HMS-Wert ab.
MCI _ HMS _ SECOND Ruft die Sekundenkomponente aus einem HMS-Wert ab.
MCI _ MAKE _ HMS Erstellt einen HMS-Wert.
MCI _ MAKE _ MSF Erstellt einen MSF-Wert.
MCI _ MAKE _ TMSF Erstellt einen TMSF-Wert.
_MCI-MSF-FRAME _ Ruft die Frameskomponente aus einem MSF-Wert ab.
MCI _ MSF _ MINUTE Ruft die Minutenkomponente aus einem MSF-Wert ab.
MCI _ MSF _ SECOND Ruft die Sekundenkomponente aus einem MSF-Wert ab.
MCI _ TMSF _ FRAME Ruft die Frameskomponente aus einem TMSF-Wert ab.
MCI _ TMSF _ MINUTE Ruft die Minutenkomponente aus einem TMSF-Wert ab.
MCI _ TMSF _ SECOND Ruft die Sekundenkomponente aus einem TMSF-Wert ab.
MCI _ TMSF _ TRACK Ruft die Tracks-Komponente aus einem TMSF-Wert ab.

MCI stellt außerdem zwei Nachrichten zur Verfügung: MM _ MCINOTIFY und MM _ MCISIGNAL. Die MM MCINOTIFY-Nachricht benachrichtigt eine Anwendung über das Ergebnis eines MCI-Befehls, wenn dieser Befehl das _ Flag "notify" (MCI _ NOTIFY) angibt. Die MM _ MCISIGNAL-Nachricht ist spezifisch für Digitalvideogeräte. Sie benachrichtigt die Anwendung, wenn eine angegebene Position erreicht wird.