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
);

Paramètres

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.)

Valeur renvoyée

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

Notes

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.

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]
En-tête	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI