info, commande
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] |