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, le cas échéant. 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 C-language pour contrôler les appareils multimédias. Il utilise un paradigme de passage de message pour communiquer avec les appareils MCI. Vous pouvez envoyer une commande à l’aide de la fonctionmciSendCommand.

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 d’un message constant
• Structure contenant des paramètres pour la commande
• Ensemble d’indicateurs spécifiant des options pour la commande et la validation des champs dans le bloc de paramètres

L’exemple suivant utilise la fonction mciSendCommand pour envoyer la commande MCI_ PLAY à 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 commandeOPENMCI_. Le dernier paramètre est l’adresse d’une structure MCI_ PLAY_ PARMS, qui peut contenir des informations sur l’emplacement de début et de fin de 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 message MM_ MCINOTIFY une fois l’opération terminée.