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

Vous pouvez utiliser plusieurs raccourcis lorsque vous utilisez des commandes MCI. Ces raccourcis vous permettent d’utiliser un identificateur unique pour faire référence à tous les appareils que votre application a ouverts, ou d’ouvrir un appareil sans émettre explicitement de commande open (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 séquentiellement à tous les appareils ouverts par l’application actuelle.

Par exemple, la commande close « all » ferme tous les appareils ouverts et la commande play « 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ù le premier et le dernier appareil reçoivent la commande.

L’utilisation de « tout » est un moyen pratique de diffuser une commande sur tous vos appareils, mais vous ne devez pas compter sur celle-ci pour synchroniser les appareils ; le délai 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 dans le Registre. Pour utiliser un appareil spécifique, vous pouvez combiner le nom de l’appareil avec le nom du fichier à l’aide du point d’exclamation, comme décrit dans le matériel de référence pour la commande open .

Si une application utilise la fonctionnalité d’ouverture automatique pour ouvrir un appareil, l’application doit case activée la valeur de retour de chaque commande ouverte suivante pour vérifier que l’appareil est toujours ouvert. MCI ferme également automatiquement tous les appareils 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.