Classifications des commandes MCI

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

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

• commandes système sont gérées directement par MCI, plutôt que par le pilote.
• commandes requises sont gérées par le pilote. Tous les pilotes MCI doivent prendre en charge les commandes et indicateurs requis.
• commandes de base (ou 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.
• commandes étendues sont spécifiques à un type ou un pilote de périphérique. Les commandes étendues incluent des commandes, telles que les commandes put (MCI_PUT) et où (MCI_WHERE) commandes pour les digitalvideo et types d’appareils et les extensions aux commandes existantes (comme l’indicateur « stretch » de l' (MCI_STATUS) pour le type d’appareil de superposition).

Bien que les commandes système et requises soient le jeu de commandes minimal 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 des 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 fonctionnalité (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, plutôt que de les transmettre aux appareils MCI.

Corde	Message	Description
d’arrêt	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.

Corde	Message	Description
fonctionnalité	MCI_GETDEVCAPS	Obtient les fonctionnalités d’un appareil.
fermer	MCI_CLOSE	Ferme l’appareil.
informations	MCI_INFO	Obtient des informations textuelles à partir d’un appareil.
ouvrir	MCI_OPEN	Initialise l’appareil.
d’état	MCI_STATUS	Obtient les informations d’état 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.

Corde	Message	Description
charger	MCI_LOAD	Charge des données à partir d’un fichier.
suspendre	MCI_PAUSE	Arrête de jouer. La lecture ou l’enregistrement peut être repris à la position actuelle.
jouer	MCI_PLAY	Commence à transmettre des données de sortie.
enregistrement	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.
enregistrer	MCI_SAVE	Enregistre les données dans un fichier de disque.
rechercher	MCI_SEEK	Cherche vers l’avant ou vers l’arrière.
définir	MCI_SET	Définit l’état d’exploitation de l’appareil.
d’état	D’ÉTAT MCI	Obtient des informations d’état sur l’appareil. Il s’agit également d’une commande requise ; é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 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 d’appareil particulier. Par exemple, le jeu de commandes pour le sequencer type d’appareil étend la commande set (MCI_SET) pour ajouter des formats de temps nécessaires aux séquenceurs MIDI.

Vous ne devez pas supposer que l’appareil prend en charge les commandes ou indicateurs étendus. Vous pouvez utiliser la commande fonctionnalité (MCI_GETDEVCAPS) pour déterminer si une fonctionnalité spécifique est prise en charge et que 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.

Corde	Message	Types d’appareils	Description
configurer	MCI_CONFIGURE	digitalvideo	Affiche une boîte de dialogue de configuration.
indicateur	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.
d’échappement	MCI_ESCAPE	vidéodisque	Envoie des informations personnalisées à un appareil.
geler	MCI_FREEZE	superposer	Désactive l’acquisition vidéo dans la mémoire tampon d’images.
	PUT MCI	digitalvideo, superposition	Définit les fenêtres source, destination et frame.
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	vidéodisque	Démarre l’épinglage du disque ou arrête le disque de tourner.
étape	MCI_STEP	digitalvideo, videodisc	Effectue les étapes de lecture d’une ou de plusieurs images vers l’avant ou l’inverse.
dégeler	MCI_UNFREEZE	superposer	Permet à la mémoire tampon d’images d’acquérir des données vidéo.
de mise à jour	MCI_UPDATE	digitalvideo	Repeint le cadre actuel dans le contexte de l’appareil.
où	MCI WHERE	digitalvideo, superposition	Obtient le rectangle spécifiant la source, la destination ou la zone frame.
fenêtre	MCI_WINDOW	digitalvideo, superposition	Contrôle la fenêtre d’affichage.