commande status

Notes

Communication sans biais Microsoft prend en charge un environnement diversifié et inclusionnaire. Dans ce document, il existe des références au mot « esclave ». Microsoft’s Style Guide for Bias-Free Communications reconnaît cela comme un mot d’exclusion. Ce libellé est utilisé comme il s’agit actuellement du libellé utilisé dans les commandes. Par souci de cohérence, ce document contient ce mot. Lorsque ce mot est modifié dans les commandes, nous corrigeons l’alignement de ce document.

La commande status demande status informations à partir d’un appareil. Tous les appareils reconnaissent cette commande.

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

_stprintf_s(
  lpszCommand,
  TEXT("status %s %s %s"),
  lpszDeviceID,
  lpszRequest,
  lpszFlags
);
      

Paramètres

lpszDeviceID

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

lpszRequest

Indicateur de demande d’informations status. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande status et les indicateurs utilisés par chaque type.

Type d’appareil	Indicateurs de requête
cdaudio	numéro de piste de type cdaudio piste actuelle length numéro de piste de longueur médias présents mode nombre de pistes position numéro de la piste de position ready position de début format horaire
digitalvideo	audio alignement audio bits audiopersample interruptions audio octets audiopersec entrée audio enregistrement audio source audio exemples audiopersec flux audio Basse bitsperpel luminosité couleur élevé piste actuelle lecteur d’espace disque saisie semi-automatique de fichier format de fichier mode fichier forward Images ignorées gamma entrée volume gauche length numéro de piste de longueur médias présents mode monitor monitor, méthode Nominale fréquence d’images nominale fréquence d’images d’enregistrement nominale nombre de pistes sortie poignée de palette mode pause vitesse de lecture position numéro de la piste de position ready fréquence d’images d’enregistrement cadre de référence taille réservée volume droit rechercher exactement Netteté Smpte speed position de début Format de fichier still format horaire Teinte Aigus Unsaved video index de clé vidéo couleur de la clé vidéo enregistrement vidéo source vidéo numéro de source vidéo flux vidéo volume handle de fenêtre fenêtre visible fenêtre réduite fenêtre agrandie
superposition	médias présents mode nombre de pistes ready étirement handle de fenêtre
sequencer	piste actuelle type division length master numéro de piste de longueur médias présents mode nombre de pistes offset port position numéro de la piste de position ready Esclave position de début Tempo format horaire
Magnétoscope	assembler l’enregistrement moniteur audio numéro de moniteur audio enregistrement audio numéro de piste de l’enregistrement audio source audio numéro de source audio channel numéro du tuner de canal horloge ID d’horloge counter format compteur résolution de compteur piste actuelle fréquence d’images index index sur length numéro de piste de longueur médias présents type de média mode nombre de pistes audio nombre de pistes nombre de pistes vidéo délai d’attente format de lecture position position de début numéro de la piste de position durée du postroll Sous tension durée du préroll ready format d’enregistrement speed format horaire mode de temps type d’heure timecode présent enregistrement timecode type timecode Numéro du tuner moniteur vidéo numéro du moniteur vidéo enregistrement vidéo numéro de piste de l’enregistrement vidéo source vidéo numéro de source vidéo en écriture protégée
vidéodisc	piste actuelle taille du disque forward length numéro de piste de longueur médias présents type de média mode nombre de pistes position numéro de la piste de position ready Côté speed position de début format horaire
waveaudio	alignement bitspersample bytespersec channels piste actuelle balise format entrée length numéro de piste de longueur niveau médias présents mode nombre de pistes sortie position numéro de piste de position ready samplespersec position de début format horaire

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

Valeur	Signification
alignement	Retourne l’alignement par bloc des données, en octets.
assembler l’enregistrement	Retourne TRUE si l’appareil est défini sur l’enregistrement en mode d’assemblage.
audio	Retourne « on » ou « off » en fonction de la commande setaudio la plus récente « on » ou « off ». Elle retourne « on » si l’un des haut-parleurs ou les deux sont activés, et « off » dans le cas contraire.
alignement audio	Retourne l’alignement des blocs de données par rapport au début des données audio de forme d’onde d’entrée.
bits audiopersample	Retourne le nombre de bits par échantillon utilisé par l’appareil pour l’enregistrement. Cet indicateur s’applique uniquement aux appareils prenant en charge l’algorithme « pcm ».
pauses audio	Retourne le nombre de fois que la partie audio de la dernière séquence AVI s’est rompue. Le système compte une coupure audio chaque fois qu’il tente d’écrire des données audio dans le pilote de périphérique et découvre que le pilote a déjà lu toutes les données disponibles. Cet indicateur est reconnu uniquement par le pilote de vidéo numérique MCIAVI. Il est destiné à l’évaluation des performances uniquement ; la valeur de retour est difficile à interpréter.
octets audiopersec	Retourne le nombre moyen d’octets par seconde utilisé pour l’enregistrement.
entrée audio	Retourne le niveau audio instantané approximatif du signal audio d’entrée analogique. Une valeur supérieure à 1 000 implique une distorsion de découpage. Certains appareils peuvent retourner cette valeur uniquement lors de l’enregistrement audio. La valeur n’a pas de commande set ou setaudio associée.
moniteur audio	Retourne « output » ou l’un des types d’entrée source valides. Pour plus d’informations, consultez la commande setaudio « monitor ».
numéro de moniteur audio	Retourne le numéro de la vidéo surveillée du type spécifié par status « moniteur audio ». Pour plus d’informations, consultez la commande setaudio .
enregistrement audio	Retourne « on » ou « off », reflétant l’état défini par setaudio « record ».
numéro de piste de l’enregistrement audio	Retourne TRUE si le magnétoscope est défini pour enregistrer l’audio. Si aucun numéro de piste n’est fourni, la valeur par défaut de 1 est supposée.
exemples audiopersec	Retourne le nombre d’échantillons enregistrés par seconde.
source audio	Retourne la source du numériseur audio actuel : « left », « right », « average » ou « stereo ».
numéro de source audio	Retourne le numéro de la source audio du type retourné par status « source audio ». Pour plus d’informations, consultez la commande setaudio .
flux audio	Retourne le numéro de flux audio actuel.
Basse	Retourne le niveau audio-bass actuel.
bitsperpel	Retourne le nombre de bits par pixel pour enregistrer les données capturées ou enregistrées.
bitspersample	Retourne les bits par exemple.
luminosité	Retourne le niveau de luminosité vidéo actuel.
bytespersec	Retourne le nombre moyen d’octets par seconde lus ou enregistrés.
numéro de piste de type cdaudio	Retourne le type du numéro de piste spécifié. Il peut s’agir de « audio » ou « autre ».
channel	Retourne la valeur entière du canal défini sur le tuner.
numéro d’accordeur de canal	Si le numéro « tuner » est indiqué, le canal actuellement sélectionné sur le numéro d’accordeur logique est retourné. Notez qu’il peut y avoir plusieurs tuners logiques.
channels	Retourne le nombre de canaux définis (1 pour mono, 2 pour stéréo).
horloge	Retourne l’heure externe. L’heure doit être un entier long non signé exprimant des incréments totaux. Pour plus d’informations, consultez la commande « fréquence d’incrémentation d’horloge ».
id d’horloge	Retourne un entier unique identifiant l’horloge.
couleur	Retourne le niveau de couleur actuel.
élevé	Retourne le niveau de contraste actuel.
counter	Retourne la position du compteur, au format de compteur actuel.
format de compteur	Retourne le format de compteur actuel. Pour plus d’informations, consultez la commande set « counter format ».
résolution de compteur	Retourne « frames » ou « seconds », indiquant la résolution du compteur. Ce n’est pas la même chose que la précision.
piste actuelle	Retourne la piste actuelle. Le séquenceur MCISEQ retourne 1.
taille du disque	Retourne 8 ou 12, indiquant la taille du disque chargé en pouces.
lecteur d’espace disque	Retourne l’espace disque approximatif, au format d’heure actuel, qui peut être obtenu par une commande de réserve pour le lecteur de disque spécifié. Le lecteur est généralement spécifié sous la forme d’une lettre unique ou d’une lettre unique suivie d’un signe deux-points (:). Toutefois, certains appareils peuvent utiliser un chemin d’accès.
type division	Retourne l’un des types de division de fichiers suivants : PPQN Frame SMPTE 24 Frame SMPTE 25 Drop frame SMPTE 30 Frame SMPTE 30 Utilisez ces informations pour déterminer le format du fichier MIDI et la signification des informations de tempo et de position.
saisie semi-automatique des fichiers	Retourne le pourcentage estimé d’une opération de chargement, d’enregistrement, de capture, de coupure, de copie, de suppression, de collage ou d’annulation . (Les applications peuvent l’utiliser pour fournir un indicateur visuel de progression.)
format de fichier	Retourne le format de fichier actuel pour les commandes d’enregistrement ou d’enregistrement .
mode fichier	Retourne « loading », « saving », « editing » ou « idle ». Pendant une opération de chargement , elle retourne « loading ». Pendant les opérations d’enregistrement et de capture , elle retourne « enregistrement ». Pendant les opérations couper, copier, supprimer, coller ou annuler , elle retourne « modification ».
balise format	Retourne la balise de format.
forward	Retourne TRUE si la direction de lecture est vers l’avant ou si l’appareil n’est pas en cours de lecture.
fréquence d’images	Retourne le nombre d’images par seconde que l’appareil utilisera par défaut. Les appareils NTSC retournent 30, PAL 25, etc.
images ignorées	Retourne le nombre d’images qui n’ont pas été dessinées lors de la lecture de la dernière séquence AVI. Cet indicateur est reconnu uniquement par le pilote de vidéo numérique MCIAVI. Il est destiné à l’évaluation des performances uniquement ; la valeur de retour est difficile à interpréter.
gamma	Retourne la valeur définie avec la valeursetvideo « gamma to ».
index	Retourne l’affichage de l’index actuel. Pour plus d’informations, consultez la commande set « index ».
index sur	Retourne TRUE si l’index est activé.
entrée	Retourne le jeu d’entrée. Si un appareil n’est pas défini, l’erreur retournée indique que n’importe quel appareil peut être utilisé. Pour les appareils vidéo numériques, modifie l’indicateur « graves », « aigus », « volume », « luminosité », « couleur », « contraste », « gamma », « netteté » ou « teinte » afin qu’il s’applique uniquement à l’entrée. Il s’agit de la valeur par défaut lors de la surveillance de l’entrée.
volume gauche	Retourne le volume défini pour le canal audio gauche.
length	Retourne la longueur totale du média, au format d’heure actuel. Pour les fichiers PPQN, la longueur est retournée en unités de pointeur de chanson. Pour les fichiers SMPTE, il est retourné sous la forme hh:mm:ss:ff, où hh est heures, mm est minutes, ss est secondes et ff est images. Pour les appareils VCR, la longueur est de 2 heures (sauf si la longueur a été explicitement modifiée à l’aide de la commande set ).
numéro de piste de longueur	Retourne la longueur de la piste, dans le temps ou les cadres, spécifiée par nombre. Pour les fichiers PPQN, la longueur est retournée en unités de pointeur de chanson. Pour les fichiers SMPTE, il est retourné sous la forme hh:mm:ss:ff, où hh est heures, mm est minutes, ss est secondes et ff est images.
niveau	Retourne la valeur de l’exemple audio PCM actuel.
master	Retourne « midi », « none » ou « smpte » en fonction du type de jeu de synchronisation.
médias présents	Retourne TRUE si le média est inséré dans l’appareil ou FALSE dans le cas contraire. Les appareils Sequencer, video-overlay, digital-video et waveform-audio retournent TRUE.
type de média	Retourne le type du média. Pour VCRS, il s’agit de « 8mm », « vhs », « svhs », « beta », « Hi8 », « edbeta » ou « other ». Pour les vidéodiscs, il s’agit de « CAV », « CLV » ou « other », selon le type de videodisc.
mode	Retourne le mode actuel de l’appareil. Tous les appareils peuvent retourner les valeurs « not ready », « paused », « playing » et « stopped ». Certains appareils peuvent retourner les valeurs « open », « parked », « recording » et « seeking » supplémentaires.
monitor	Retourne « file » ou « input ». La valeur retournée indique la source de présentation actuelle.
monitor, méthode	Retourne « pre », « post » ou « direct ». La valeur retournée indique la méthode utilisée pour la surveillance des entrées.
Nominale	L’élément modifie les indicateurs « basse », « luminosité », « couleur », « contraste », « gamma », « netteté », « teinte », « aiguë » et « volume » pour retourner la valeur nominale au lieu du paramètre actuel.
fréquence d’images nominale	Retourne la fréquence d’images nominale associée au fichier. Les unités sont en images par seconde multipliées par 1000.
fréquence d’images d’enregistrement nominal	Retourne la fréquence d’images nominale associée au signal vidéo d’entrée. Les unités sont en images par seconde multipliées par 1000.
nombre de pistes audio	Retourne le nombre de pistes audio sur le média.
nombre de pistes	Retourne le nombre de pistes sur le média. Les appareils MCISEQ et MCIWAVE retournent 1, comme la plupart des appareils VCR. L’appareil MCIPIONR ne prend pas en charge cet indicateur.
nombre de pistes vidéo	Retourne le nombre de pistes vidéo sur le média.
offset	Retourne le décalage d’un fichier basé sur SMPTE. Le décalage est l’heure de début d’une séquence basée sur SMPTE. L’heure est retournée sous la forme hh:mm:ss:ff, où hh est en heures, mm en minutes, ss en secondes et ff en images.
sortie	Retourne la sortie actuellement définie. Si aucune sortie n’est définie, l’erreur retournée indique que n’importe quel appareil peut être utilisé. Pour les appareils vidéo numériques, modifie l’indicateur « basses », « aigus », « volume », « luminosité », « couleur », « contraste », « gamma », « netteté » ou « teinte » afin qu’il ne s’applique qu’à la sortie. Il s’agit de la valeur par défaut lors de la surveillance d’un fichier.
mode pause	Retourne « enregistrement » si l’appareil est suspendu pendant l’enregistrement. Il retourne « lecture » si l’appareil est suspendu pendant la lecture. Il retourne l’erreur « Action non applicable en mode actuel » si l’appareil n’est pas suspendu.
délai d’attente	Retourne la durée maximale, en millisecondes, d’une commande de pause .
format de lecture	Renvoie un code indiquant le format de lecture de la bande vidéo, s’il est détectable : « lp », « ep », « sp » ou « other ». Pour plus d’informations, consultez l’indicateur « format d’enregistrement ».
vitesse de lecture	Retourne une valeur qui représente la façon dont le temps de lecture réel de la dernière séquence AVI correspond au temps de lecture cible. La valeur 1000 indique que l’heure cible et l’heure réelle étaient identiques. Une valeur de 2000, par exemple, indiquerait que la séquence AVI a pris deux fois plus de temps à jouer qu’elle aurait dû. Cet indicateur est reconnu uniquement par le pilote vidéo numérique MCIAVI. Il est destiné uniquement à l’évaluation des performances; la valeur de retour est difficile à interpréter.
port	Retourne le numéro de port MIDI attribué à la séquence.
position	Retourne la position actuelle. Pour les fichiers PPQN, la position est retournée en unités de pointeur de chanson. Pour les fichiers SMPTE, il est retourné en tant que hh:mm:ss:ff, où hh est heures, mm en minutes, ss en secondes et ff en images.
position de début	Retourne la position du début du média utilisable.
numéro de la piste de position	Retourne la position du début de la piste spécifiée par nombre. Pour les fichiers PPQN, le format d’heure est retourné en unités de pointeur de chanson. Pour les fichiers SMPTE, il est retourné en tant que hh:mm:ss:ff, où hh est heures, mm en minutes, ss en secondes et ff en images. Le séquenceur MCISEQ retourne zéro. L’appareil MCIPIONR ne prend pas en charge cet indicateur. L’appareil MCIWAVE retourne zéro.
durée du postroll	Retourne la longueur de la bande vidéo, au format d’heure actuel, nécessaire pour freiner le transport du magnétoscope lors de l’émission d’une commande d’arrêt ou de pause .
Sous tension	Retourne TRUE si l’alimentation du magnétoscope est activée.
durée du préroll	Retourne la longueur de la bande vidéo, au format d’heure actuel, nécessaire pour stabiliser la sortie du magnétoscope.
ready	Retourne TRUE si l’appareil est prêt à accepter une autre commande.
format d’enregistrement	Retourne un code indiquant le format dans lequel la bande vidéo sera enregistrée. Les types de retour actuels sont « lp », « ep », « sp » ou « other ». Ces formats ne sont pas spécifiques à VHS et peuvent être appliqués à n’importe quel magnétoscope qui a plusieurs formats d’enregistrement sélectionnables. Le type « sp » est le format d’enregistrement le plus rapide et de la plus haute qualité et est utilisé par défaut sur les magnétoscopes de format unique.
fréquence d’images d’enregistrement	Retourne la fréquence d’images, en images par seconde multipliée par 1000, utilisée pour la compression.
cadre de référence	Retourne le numéro d’image de l’image clé la plus proche qui précède le cadre spécifié.
taille réservée	Retourne la taille, au format d’heure actuel, de l’espace de travail réservé. La taille correspond au temps approximatif nécessaire pour lire les données compressées à partir d’un espace de travail complet. Elle retourne zéro s’il n’y a pas d’espace disque réservé. Cet indicateur retourne la taille approximative, car l’espace disque précis des données compressées ne peut, en général, être prédit qu’après la compression des données.
volume droit	Retourne le jeu de volumes pour le canal audio approprié.
samplespersec	Retourne le nombre d’échantillons par seconde lus ou enregistrés.
rechercher exactement	Retourne « on » ou « off », indiquant si l’indicateur « seek exact » est défini ou non.
Netteté	Retourne le niveau de netteté actuel de l’appareil.
Côté	Retourne 1 ou 2 pour indiquer quel côté du vidéodisc est chargé.
Esclave	Retourne « file », « midi », « none » ou « smpte » en fonction du type de jeu de synchronisation.
Smpte	Retourne le timecode SMPTE associé à la position actuelle dans l’espace de travail. Il s’agit d’une chaîne au format dd:dd:dd:dd, où chaque d désigne un chiffre de 0 à 9. Si les données de l’espace de travail n’incluent pas de données timecode, cet indicateur renvoie 00:00:00:00.
speed	Retourne la vitesse actuelle de l’appareil en images par seconde (ou dans le même format que celui utilisé par la commande set « speed »). Le lecteur vidéodisc MCIPIONR ne prend pas en charge cet indicateur.
position de début	Retourne la position de départ du média.
Format de fichier still	Retourne le format de fichier actuel pour la commande de capture .
étirement	Retourne TRUE si l’étirement est activé.
Tempo	Retourne le tempo actuel d’une séquence MIDI au format d’heure actuelle. Pour les fichiers au format PPQN, le tempo est en battements par minute. Pour les fichiers au format SMPTE, le tempo est en images par seconde.
format horaire	Retourne le format d’heure actuel. Pour plus d’informations, consultez les formats d’heure dans la commande set .
mode de temps	Retourne le mode d’heure de position actuelle. Il peut s’agir de « detect », « timecode » ou « counter ».
type d’heure	Retourne l’heure de position actuelle en cours d’utilisation : « timecode » ou « counter ».
timecode présent	Retourne TRUE si le timecode a été enregistré à la position actuelle sur la bande. Le timecode doit avancer à partir de la position actuelle. Il peut être nécessaire de lire un magnétoscope pour case activée cette condition.
enregistrement timecode	Retourne TRUE si le magnétoscope est défini pour enregistrer le timecode.
type timecode	Retourne « smpte », « smpte drop », « other » ou « none ». Notez que les images par seconde peuvent être obtenues à partir de la commande status « fréquence d’images », et que la précision de l’appareil peut être retournée par la commande « rechercher la précision ».
Teinte	Retourne le niveau de teinte vidéo actuel.
Aigus	Retourne le niveau audio-aigu actuel.
Numéro du tuner	Retourne le numéro de tuner logique actuel.
Unsaved	Retourne TRUE si des données enregistrées dans l’espace de travail peuvent être perdues à la suite d’une commande de fermeture, de chargement, d’enregistrement, de réservation, de suppression ou de collage. Retourne LA VALEUR FALSE dans le cas contraire.
video	Retourne « on » ou « off », reflétant l’état défini par la commande setvideo .
couleur de la clé vidéo	Retourne la valeur de la couleur de clé.
index de clé vidéo	Retourne la valeur de l’index de clé.
moniteur vidéo	Retourne « output » ou l’un des types d’entrée source valides. Pour plus d’informations, consultez la commande setvideo « monitor ».
numéro du moniteur vidéo	Retourne le numéro de vidéo surveillée du type retourné par status « moniteur vidéo ». Pour plus d’informations, consultez la commande setvideo .
enregistrement vidéo	Retourne « on » ou « off », reflétant l’état actuel défini par setvideo « record ».
numéro de piste de l’enregistrement vidéo	Retourne TRUE si le magnétoscope est configuré pour enregistrer la vidéo. Si aucun numéro de suivi n’est donné, la valeur par défaut 1 est supposée.
source vidéo	Retourne le type de source vidéo. Pour plus d’informations, consultez la commande setvideo .
numéro de source vidéo	Retourne un nombre correspondant à la source vidéo du type utilisé. Par exemple, elle retourne 2 si la deuxième entrée de source vidéo NTSC est utilisée.
flux vidéo	Retourne le numéro actuel du flux vidéo.
volume	Retourne le volume moyen à l’orateur gauche et droit. Cela retourne une erreur si l’appareil n’a pas été lu ou si le volume n’a pas été défini.
handle de fenêtre	Retourne la valeur décimale ASCII pour le handle de fenêtre dans le mot de bas ordre de la valeur de retour.
fenêtre agrandie	Retourne TRUE si la fenêtre est agrandie.
fenêtre réduite	Retourne TRUE si la fenêtre est réduite.
fenêtre visible	Retourne TRUE si la fenêtre n’est pas masquée.
en écriture protégée	Retourne TRUE si l’appareil détecte qu’il ne peut pas enregistrer (autrement dit, si la protection en écriture est activée). S’il peut enregistrer ou s’il n’est pas en mesure de déterminer s’il peut enregistrer ou non (sans écrire réellement), le pilote retourne FALSE.

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 des informations dans le paramètre lpszReturnString de mciSendString. Les informations dépendent du type de demande.

Notes

Avant d’émettre des commandes qui utilisent des valeurs de position, vous devez définir le format de temps souhaité à l’aide de la commande set .

Exemples

La commande suivante retourne le mode actuel de l’appareil « mysound ».

status mysound mode

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

capability

Capture

close

Couper

delete

load

pause

Coller

enregistrement

Réserve

enregistrer

set

setaudio

setvideo

stop

annuler