info, commande

Article
06/13/2023

La commande info récupère une description matérielle à partir d’un appareil. Tous les appareils MCI reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand, 
  TEXT("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
);

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszInfoType

Indicateur qui identifie le type d’informations requises. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande info et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
cdaudio	info identityinfo upc	product
digitalvideo	algorithme audioaudio qualityfileproductstill algorithmstill quality	usageversionvideo algorithmvideo qualitywindow text
superposition	fileproduct	texte de fenêtre
sequencer	copyrightfile	nameproduct
Magnétoscope	product	version
videodisk	product
waveaudio	fileinput	outputproduct

Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszInfoType et leurs significations.

Valeur	Signification
algorithme audio	Retourne le nom de l’algorithme de compression audio actuel.
qualité audio	Retourne le nom du descripteur de qualité audio actuel. Cela peut renvoyer « inconnu » si l’application a défini des paramètres sur des valeurs spécifiques qui ne correspondent pas à des qualités définies.
copyright	Récupère l’avis de copyright de fichier MIDI à partir de l’événement meta copyright.
fichier	Récupère le nom du fichier utilisé par l’appareil composé. Si l’appareil est ouvert sans fichier et que la commande load n’a pas été utilisée, une chaîne null est retournée.
identité d’informations	Produit un identificateur unique pour le CD audio actuellement chargé dans le lecteur interrogé.
upc des informations	Produit le code de produit universel (UPC) qui est encodé sur un CD audio. L’UPC est une chaîne de chiffres. Il n’est peut-être pas disponible pour tous les CD.
entrée	Récupère la description de l’appareil d’entrée actuel. Retourne « none » si un périphérique d’entrée n’est pas défini.
name	Récupère le nom de la séquence à partir de l’événement meta de nom de séquence/piste.
sortie	Récupère la description de l’appareil de sortie actuel. Retourne « none » si un appareil de sortie n’est pas défini.
product	Récupère une description de l’appareil. Ces informations incluent souvent le nom du produit et le modèle. La longueur de chaîne sera de 31 caractères ou moins.
algorithme still	Retourne le nom de l’algorithme de compression d’images fixes actuel.
qualité toujours	Retourne le nom du descripteur de qualité d’image fixe actuel. Cela peut renvoyer « inconnu » si l’application a défini des paramètres sur des valeurs spécifiques qui ne correspondent pas à des qualités définies.
usage	Retourne une chaîne décrivant les restrictions d’utilisation qui peuvent être imposées par le propriétaire des données visuelles ou audio dans l’espace de travail.
version	Retourne le niveau de mise en production du pilote de périphérique et du matériel.
algorithme vidéo	Retourne le nom de l’algorithme de compression vidéo actuel.
qualité vidéo	Retourne le nom du descripteur de qualité vidéo actuel. Cela peut renvoyer « inconnu » si l’application a défini des paramètres sur des valeurs spécifiques qui ne correspondent pas à des qualités définies.
texte de fenêtre	Récupère le légende de la fenêtre utilisée par l’appareil.

lpszFlags

Peut être « attendre », « notifier » ou les deux. Pour les appareils de vidéo numérique et de magnétoscope, « test » peut également être spécifié. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Exemples

La commande suivante récupère une description du matériel associé à l’appareil « mysound ».

info mysound product

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

MCI
Chaînes de commande MCI
load

Partager via