Messages de commande

[La fonctionnalité associée à cette page, MCI, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de MCI, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’interface de message de commande est conçue pour être utilisée par les applications nécessitant une interface en langage C pour contrôler les appareils multimédias. Il utilise un paradigme de transmission de messages pour communiquer avec les appareils MCI. Vous pouvez envoyer une commande à l’aide de la fonction mciSendCommand .

La fonction mciSendCommand retourne zéro si elle réussit. Si la fonction échoue, le mot de bas ordre de la valeur de retour contient un code d’erreur. Vous pouvez transmettre ce code d’erreur à la fonction mciGetErrorString pour obtenir une description textuelle de l’erreur.

Syntaxe des messages de commande

Les messages de commande MCI se composent des éléments suivants :

• Valeur de message constante
• Structure contenant les paramètres de la commande
• Ensemble d’indicateurs spécifiant des options pour la commande et validant les champs dans le bloc de paramètres

L’exemple suivant utilise la fonction mciSendCommand pour envoyer la commande play MCI_ à l’appareil identifié par un identificateur d’appareil.

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

L’identificateur d’appareil donné dans le premier paramètre est récupéré lorsque l’appareil est ouvert à l’aide de la commande open MCI_ . Le dernier paramètre est l’adresse d’une structure PARMS MCI_ PLAY_ , qui peut contenir des informations sur l’emplacement de début et de fin de la lecture. De nombreux messages de commande MCI utilisent une structure pour contenir des paramètres de ce type. Le premier membre de chacune de ces structures identifie la fenêtre qui reçoit un MM_ message MCINOTIFY à la fin de l’opération.