Befehlsnachrichten

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

Die Befehlsmeldungsschnittstelle wurde für Anwendungen entwickelt, die eine C-Sprachschnittstelle zum Steuern von Multimediageräten erfordern. Es verwendet ein Nachrichtenübergabeparadigma, um mit MCI-Geräten zu kommunizieren. Sie können einen Befehl mithilfe der funktion mciSendCommand senden.

Die mciSendCommand--Funktion gibt null zurück, wenn die Funktion erfolgreich verläuft. Wenn die Funktion fehlschlägt, enthält das Wort mit niedriger Reihenfolge des Rückgabewerts einen Fehlercode. Sie können diesen Fehlercode an die mciGetErrorString--Funktion übergeben, um eine Textbeschreibung des Fehlers abzurufen.

Syntax von Befehlsnachrichten

MCI-Befehlsmeldungen bestehen aus den folgenden Elementen:

• Ein konstanter Nachrichtenwert
• Eine Struktur, die Parameter für den Befehl enthält
• Eine Reihe von Flags, die Optionen für den Befehl und das Überprüfen von Feldern im Parameterblock angeben

Im folgenden Beispiel wird die mciSendCommand--Funktion verwendet, um den befehl MCI_ PLAY an das Gerät zu senden, das durch einen Gerätebezeichner identifiziert wird.

mciSendCommand(wDeviceID,            // device identifier 
    MCI_PLAY,                        // command message 
    0,                               // flags 
    (DWORD)(LPVOID) &mciPlayParms);  // parameter block 

Der im ersten Parameter angegebene Gerätebezeichner wird abgerufen, wenn das Gerät mit dem Befehl MCI_ OPEN geöffnet wird. Der letzte Parameter ist die Adresse einer MCI_ PLAY_ PARMS- Struktur, die Informationen dazu enthalten kann, wo die Wiedergabe beginnen und enden soll. Viele MCI-Befehlsmeldungen verwenden eine Struktur, um Parameter dieser Art zu enthalten. Das erste Mitglied jeder dieser Strukturen identifiziert das Fenster, das eine MM_ MCINOTIFY Nachricht empfängt, wenn der Vorgang abgeschlossen ist.