commande MCI_INFO
La commande MCI_INFO récupère des informations de chaîne à partir d’un appareil. Tous les appareils reconnaissent cette commande. Les informations sont retournées dans le membre lpstrReturn de la structure identifiée par lpInfo. Le membre dwRetSize spécifie la longueur de la mémoire tampon pour les données retournées.
Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_INFO,
DWORD dwFlags,
(DWORD) (LPMCI_INFO_PARMS) lpInfo
);
-
wDeviceID
-
Identificateur de l’appareil MCI devant recevoir le message de commande.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou, pour les appareils de vidéo numérique et de magnétoscope, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.
-
lpInfo
-
Pointeur vers une structure MCI_INFO_PARMS . (Les appareils avec des jeux de commandes étendus peuvent remplacer cette structure par une structure spécifique à l’appareil.)
Retourne zéro en cas de réussite ou une erreur dans le cas contraire.
L’indicateur standard et spécifique aux commandes suivant s’applique à tous les appareils prenant en charge MCI_INFO :
-
MCI_INFO_PRODUCT
-
Obtient une description du matériel associé à un appareil. Les appareils doivent fournir une description qui identifie à la fois le pilote et le matériel utilisé.
Les indicateurs supplémentaires suivants s’appliquent au type d’appareil cdaudio :
-
MCI_INFO_MEDIA_IDENTITY
-
Produit un identificateur unique pour le CD audio actuellement chargé dans le lecteur interrogé. Cet indicateur retourne une chaîne de 16 chiffres hexadécimaux.
-
MCI_INFO_MEDIA_UPC
-
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.
Les indicateurs supplémentaires suivants s’appliquent au type d’appareil digitalvideo :
-
MCI_DGV_INFO_ITEM
-
Une constante indiquant les informations souhaitées est incluse dans le membre dwItem de la structure identifiée par lpInfo. Les constantes suivantes sont définies pour les appareils vidéo numériques :
-
MCI_DGV_INFO_AUDIO_ALG
-
Retourne le nom de l’algorithme de compression audio actuel.
-
MCI_DGV_INFO_AUDIO_QUALITY
-
Retourne le nom du descripteur de qualité audio actuel.
-
MCI_DGV_INFO_STILL_ALG
-
Retourne le nom de l’algorithme de compression d’image fixe actuel.
-
MCI_DGV_INFO_STILL_QUALITY
-
Retourne le nom du descripteur de qualité d’image fixe actuel.
-
MCI_DGV_INFO_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 audibles dans l’espace de travail.
-
MCI_DGV_INFO_VIDEO_ALG
-
Retourne le nom de l’algorithme de compression vidéo actuel.
-
MCI_DGV_INFO_VIDEO_QUALITY
-
Retourne le nom du descripteur de qualité vidéo actuel.
-
MCI_INFO_VERSION
-
Retourne le niveau de mise en production du pilote de périphérique et du matériel. Les développeurs de pilotes de périphérique doivent documenter la syntaxe de la chaîne retournée.
-
MCI_DGV_INFO_TEXT
-
Obtient la fenêtre légende.
-
MCI_INFO_FILE
-
Obtient le chemin d’accès et le nom de fichier du dernier fichier spécifié avec la commande MCI_OPEN ou MCI_LOAD . Si aucun fichier n’a été spécifié, l’appareil retourne une chaîne terminée par null. Cet indicateur est pris en charge uniquement par les appareils qui retournent TRUE à l’indicateur MCI_GETDEVCAPS_USES_FILES de la commande MCI_GETDEVCAPS .
Pour les appareils vidéo numériques, lpInfo pointe vers une structure MCI_DGV_INFO_PARMS .
Les indicateurs supplémentaires suivants s’appliquent au type d’appareil sequencer :
-
MCI_INFO_COPYRIGHT
-
Obtient l’avis de copyright du fichier MIDI à partir de l’événement meta copyright.
-
MCI_INFO_FILE
-
Obtient le nom de fichier du fichier actif. Cet indicateur est pris en charge uniquement par les appareils qui retournent TRUE lorsque vous appelez la commande MCI_GETDEVCAPS avec l’indicateur MCI_GETDEVCAPS_USES_FILES.
-
MCI_INFO_NAME
-
Obtient le nom de séquence à partir de l’événement meta de nom de séquence/piste.
L’indicateur supplémentaire suivant s’applique au type d’appareil vcr :
-
MCI_VCR_INFO_VERSION
-
Définit le membre lpstrReturn de la structure MCI_INFO_PARMS pour qu’il pointe vers le numéro de version. Définit également le membre dwRetSize égal à la longueur de la chaîne pointée vers.
Les indicateurs supplémentaires suivants s’appliquent au type d’appareil de superposition :
-
MCI_INFO_FILE
-
Obtient le nom de fichier du fichier actif. Cet indicateur est pris en charge uniquement par les appareils qui retournent TRUE à l’indicateur MCI_GETDEVCAPS_USES_FILES de la commande MCI_GETDEVCAPS .
-
MCI_OVLY_INFO_TEXT
-
Obtient le légende de la fenêtre associée au périphérique de superposition vidéo.
Les indicateurs supplémentaires suivants s’appliquent au type d’appareil waveaudio :
-
MCI_INFO_FILE
-
Obtient le nom de fichier du fichier actif. Cet indicateur est pris en charge par les appareils qui retournent TRUE lorsque vous appelez la commande MCI_GETDEVCAPS avec l’indicateur MCI_GETDEVCAPS_USES_FILES.
-
MCI_WAVE_INPUT
-
Obtient le nom de produit de l’entrée actuelle.
-
MCI_WAVE_OUTPUT
-
Obtient le nom de produit de la sortie actuelle et sa valeur est spécifique à l’appareil.
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] |
En-tête |
|