Partager via

Classifications des commandes MCI

  • Article

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

MCI définit quatre classifications de commandes : système, obligatoire, de base et étendu. La liste suivante décrit ces classifications de commandes :

  • Les commandes système sont gérées directement par MCI, plutôt que par le pilote.
  • Les commandes requises sont gérées par le pilote. Tous les pilotes MCI doivent prendre en charge les commandes et les indicateurs requis.
  • Des commandes de base (ou des commandes facultatives) sont utilisées par certains appareils. Si un appareil prend en charge une commande de base, il doit prendre en charge un ensemble défini d’indicateurs pour cette commande.
  • Les commandes étendues sont spécifiques à un type de périphérique ou à un pilote. Les commandes étendues incluent des commandes, telles que les commandes put (MCI_PUT) et where (MCI_WHERE) pour les types d’appareils digitalvideo et overlay, et les extensions aux commandes existantes (comme l’indicateur « stretch » de la commande status (MCI_STATUS) pour le type de périphérique de superposition).

Bien que les commandes système et requises soient le jeu de commandes minimum pour n’importe quel pilote MCI, les commandes de base et étendues ne sont pas prises en charge par tous les pilotes. Votre application peut toujours utiliser les commandes système et requises et leurs indicateurs, mais si elle doit utiliser une commande ou un indicateur de base ou étendu, elle doit d’abord interroger le pilote à l’aide de la commande de capacité (MCI_GETDEVCAPS). Les sections suivantes résument les commandes spécifiques de chaque catégorie.

Commandes système

MCI traite directement les commandes système suivantes, au lieu de les transmettre aux appareils MCI.

Chaîne Message Description
Pause MCI_BREAK Définit une clé d’arrêt pour un appareil MCI.
Sysinfo MCI_SYSINFO Retourne des informations sur les appareils MCI.

 

Commandes requises

Tous les appareils MCI prennent en charge les commandes requises suivantes.

String Message Description
Capacité MCI_GETDEVCAPS Obtient les fonctionnalités d’un appareil.
Proche MCI_CLOSE Ferme l’appareil.
info MCI_INFO Obtient des informations textuelles à partir d’un appareil.
Ouvert MCI_OPEN Initialise l’appareil.
status MCI_STATUS Obtient des informations status de l’appareil. Certains indicateurs de cette commande ne sont pas obligatoires. Il s’agit donc également d’une commande de base.

 

Les appareils doivent également prendre en charge un ensemble standard d’indicateurs de commande pour les commandes requises.

Commandes de base

La liste suivante récapitule les commandes de base. L’utilisation de ces commandes par un appareil MCI est facultative.

Chaîne Message Description
load MCI_LOAD Charge des données à partir d’un fichier.
suspendre MCI_PAUSE Arrête de jouer. La lecture ou l’enregistrement peut reprendre à la position actuelle.
play MCI_PLAY Commence la transmission des données de sortie.
enregistrer MCI_RECORD Démarre l’enregistrement des données d’entrée.
Reprendre MCI_RESUME Reprend la lecture ou l’enregistrement sur un appareil suspendu.
sauvegarder MCI_SAVE Enregistre les données dans un fichier de disque.
Chercher MCI_SEEK Recherche vers l’avant ou vers l’arrière.
Ensemble MCI_SET Définit l’état de fonctionnement de l’appareil.
status ÉTAT DE L’INSTANCE MCI Obtient status informations sur l’appareil. Il s’agit également d’une commande obligatoire ; étant donné que certains de ses indicateurs ne sont pas obligatoires, il est également répertorié ici. (Les éléments facultatifs prennent en charge les appareils qui utilisent des supports linéaires avec des positions identifiables.)
Arrêter MCI_STOP Arrête de jouer.

 

Si un pilote prend en charge une commande de base, il doit également prendre en charge un ensemble standard d’indicateurs pour la commande.

Commandes étendues

Certains appareils MCI ont des commandes supplémentaires, ou ils ajoutent des indicateurs à des commandes existantes. Bien que certaines commandes étendues s’appliquent uniquement à un pilote de périphérique spécifique, la plupart d’entre elles s’appliquent à tous les pilotes d’un type de périphérique particulier. Par exemple, le jeu de commandes pour le type d’appareil sequencer étend la commande set (MCI_SET) pour ajouter les formats de temps requis par les séquenceurs MIDI.

Vous ne devez pas supposer que l’appareil prend en charge les commandes ou indicateurs étendus. Vous pouvez utiliser la commande de fonctionnalité (MCI_GETDEVCAPS) pour déterminer si une fonctionnalité spécifique est prise en charge, et votre application doit être prête à traiter les valeurs de retour « commande non prise en charge » ou « fonction non prise en charge ».

Les commandes étendues suivantes sont disponibles avec les types d’appareils répertoriés.

Chaîne Message Types d’appareil Description
CONFIGURER MCI_CONFIGURE digitalvideo Affiche une boîte de dialogue de configuration.
Indice MCI_CUE digitalvideo, waveaudio Prépare la lecture ou l’enregistrement.
Supprimer MCI_DELETE waveaudio Supprime un segment de données du fichier multimédia.
escape MCI_ESCAPE videodisc Envoie des informations personnalisées à un appareil.
Gèlent MCI_FREEZE superposition Désactive l’acquisition vidéo dans la mémoire tampon de trame.
Mettre MCI PUT digitalvideo, superposition Définit les fenêtres source, de destination et d’image.
Réaliser MCI_REALIZE digitalvideo Indique à l’appareil de sélectionner et de réaliser sa palette dans un contexte d’appareil de la fenêtre affichée.
setaudio MCI_ SETAUDIO digitalvideo Définit les paramètres audio pour la vidéo.
setvideo MCI_ SETVIDEO digitalvideo Définit les paramètres vidéo.
signal MCI_SIGNAL digitalvideo Identifie une position spécifiée avec un signal.
Spin MCI_SPIN videodisc Démarre la rotation du disque ou arrête la rotation du disque.
Étape MCI_STEP digitalvideo, videodisc Effectue la lecture d’une ou de plusieurs images vers l’avant ou l’inverse.
Dégeler MCI_UNFREEZE superposition Permet à la mémoire tampon de trame d’acquérir des données vidéo.
mettre à jour MCI_UPDATE digitalvideo Repeint le frame actuel dans le contexte de l’appareil.
Où MCI WHERE digitalvideo, superposition Obtient le rectangle spécifiant la source, la destination ou la zone de cadre.
Fenêtre MCI_WINDOW digitalvideo, superposition Contrôle la fenêtre d’affichage.