Raccourcis et variantes 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.]

Vous pouvez utiliser plusieurs raccourcis lors de l’utilisation des commandes MCI. Ces raccourcis vous permettent d’utiliser un identificateur unique pour faire référence à tous les appareils ouverts par votre application ou pour ouvrir un appareil sans émettre explicitement une commande ouvrir (MCI_OPEN).

Vous pouvez spécifier « all » (MCI_ALL_DEVICE_ID) comme identificateur d’appareil pour toute commande qui ne retourne pas d’informations. Lorsque vous spécifiez « all », MCI envoie la commande de manière séquentielle à tous les appareils ouverts par l’application actuelle.

Par exemple, la fermer commande « all » ferme tous les appareils ouverts et la lire commande « all » commence à lire tous les appareils ouverts par l’application. Étant donné que MCI envoie séquentiellement les commandes aux appareils MCI, il existe un intervalle entre le moment où les premiers et derniers appareils reçoivent la commande.

L’utilisation de « all » est un moyen pratique de diffuser une commande sur tous vos appareils, mais vous ne devez pas vous en fier pour synchroniser les appareils ; le minutage entre les messages peut varier.

Lorsque vous émettez une commande et spécifiez un appareil qui n’est pas ouvert, MCI tente d’ouvrir l’appareil avant d’implémenter la commande. Les règles suivantes s’appliquent à l’ouverture automatique des appareils :

• La fonctionnalité d’ouverture automatique fonctionne uniquement avec l’interface de chaîne de commande.
• La fonctionnalité d’ouverture automatique échoue pour les commandes spécifiques aux pilotes de périphérique personnalisés.
• Les appareils ouverts automatiquement ne répondent pas aux commandes qui utilisent « all » comme nom d’appareil.
• La fonctionnalité d’ouverture automatique ne permet pas à votre application de spécifier l’indicateur « type ». Sans le nom de l’appareil, MCI détermine le nom de l’appareil à partir des entrées du Registre. Pour utiliser un appareil spécifique, vous pouvez combiner le nom de l’appareil avec le nom de fichier à l’aide du point d’exclamation, comme décrit dans le document de référence pour la commande ouvrir.

Si une application utilise la fonctionnalité d’ouverture automatique pour ouvrir un appareil, l’application doit vérifier la valeur de retour de chaque commande ouverte suivante pour vérifier que l’appareil est toujours ouvert. MCI ferme également automatiquement tout appareil qu’il ouvre automatiquement. MCI ferme généralement un appareil dans les situations suivantes :

• La commande est terminée.
• Vous abandonnez la commande.
• Vous demandez une notification dans une commande suivante.
• MCI détecte une défaillance.