commande capability

La commande de fonctionnalité demande des informations sur une fonctionnalité particulière 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("capability %s %s %s"), 
  lpszDeviceID, 
  lpszRequest, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est affecté à l’ouverture de l’appareil.

lpszRequest

Indicateur qui identifie une fonctionnalité d’appareil. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande de fonctionnalité et les indicateurs utilisés par chaque type :

Valeur	Type	Type
cdaudio	peut éjecter peut jouer peut enregistrer peut enregistrer appareil composé	type de périphérique a de l’audio a une vidéo utilise des fichiers
digitalvideo	peut éjecter peut se figer peut verrouiller peut jouer peut enregistrer peut inverser peut enregistrer peut s’étirer peut étendre l’entrée peut tester	appareil composé type de périphérique a de l’audio a encore a une vidéo vitesse de lecture maximale taux de jeu minimal utilise des fichiers utilise des palettes windows
superposition	peut éjecter peut se figer peut jouer peut enregistrer peut enregistrer peut s’étirer	appareil composé type de périphérique a de l’audio a une vidéo utilise des fichiers windows
sequencer	peut éjecter peut jouer peut enregistrer peut enregistrer appareil composé	type de périphérique a de l’audio a une vidéo utilise des fichiers
Magnétoscope	peut détecter la longueur peut éjecter peut se figer peut surveiller les sources peut jouer peut pré-inscrire peut afficher un aperçu peut enregistrer peut inverser peut enregistrer peut tester	fréquence d’incrémentation d’horloge appareil composé type de périphérique a de l’audio a une horloge a un code de temps a une vidéo nombre de marques rechercher la précision utilise des fichiers
videodisc	peut éjecter peut jouer peut enregistrer peut inverser peut enregistrer CAV CLV appareil composé	type de périphérique vitesse de lecture rapide a de l’audio a une vidéo taux de jeu normal taux de lecture lent utilise des fichiers
waveaudio	peut éjecter peut jouer peut enregistrer peut enregistrer appareil composé type de périphérique	a de l’audio a une vidéo inputs outputs utilise des fichiers

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

Indicateurs	Signification
peut détecter la longueur	Retourne TRUE si l’appareil peut détecter la longueur du média.
peut éjecter	Retourne TRUE si l’appareil peut éjecter le média.
peut se figer	Retourne TRUE si l’appareil peut figer des données dans la mémoire tampon de trame.
peut verrouiller	Retourne TRUE si l’appareil peut verrouiller des données.
peut surveiller les sources	Retourne TRUE si l’appareil peut passer une entrée (source) à la sortie supervisée, indépendamment de la sélection d’entrée actuelle.
peut jouer	Retourne TRUE si l’appareil peut lire.
peut pré-inscrire	Retourne TRUE si l’appareil prend en charge l’indicateur « preroll » avec la commande cue .
peut afficher un aperçu	Retourne TRUE si l’appareil prend en charge les préversions.
peut enregistrer	Retourne TRUE si l’appareil prend en charge l’enregistrement.
peut inverser	Retourne TRUE si l’appareil peut jouer à l’envers.
peut enregistrer	Retourne TRUE si l’appareil peut enregistrer des données.
peut s’étirer	Retourne TRUE si l’appareil peut étirer les cadres pour remplir un rectangle d’affichage donné.
peut étendre l’entrée	Retourne TRUE si l’appareil peut redimensionner une image dans le processus de numérisation dans la mémoire tampon de trame.
peut tester	Retourne TRUE si l’appareil reconnaît l’mot clé de test.
Cav	Lorsqu’il est combiné avec d’autres éléments, cet indicateur spécifie que les informations de retour s’appliquent aux vidéodiscs au format CAV. Il s’agit de la valeur par défaut si aucun vidéodisc n’est inséré.
fréquence d’incrémentation d’horloge	Retourne le nombre de subdivisions que l’horloge externe prend en charge par seconde. Si l’horloge externe est une horloge en millisecondes, la valeur de retour est 1000. Si la valeur de retour est 0, aucune horloge n’est prise en charge.
clv	Lorsqu’il est combiné avec d’autres éléments, cet indicateur spécifie que les informations de retour s’appliquent aux vidéodiscs au format CLV.
appareil composé	Retourne TRUE si l’appareil prend en charge un nom d’élément (nom de fichier).
type de périphérique	Retourne un nom de type d’appareil, qui peut être l’un des suivants : cdaudio dat digitalvideo other superposition scanneur sequencer Magnétoscope videodisc waveaudio
vitesse de lecture rapide	Retourne le taux de lecture rapide en images par seconde, ou zéro si l’appareil ne peut pas lire rapidement.
a de l’audio	Retourne TRUE si l’appareil prend en charge la lecture audio.
a une horloge	Retourne TRUE si l’appareil a une horloge.
a encore	Retourne TRUE si l’appareil traite les fichiers avec une seule image plus efficacement que les fichiers vidéo de mouvement.
a un code de temps	Retourne TRUE si l’appareil est capable de prendre en charge le timecode ou s’il est inconnu.
a une vidéo	Retourne TRUE si l’appareil prend en charge la vidéo.
inputs	Retourne le nombre total de périphériques d’entrée.
vitesse de lecture maximale	Retourne la vitesse de lecture maximale, en images par seconde, pour l’appareil.
taux de jeu minimal	Retourne la vitesse de lecture minimale, en images par seconde, pour l’appareil.
taux de jeu normal	Retourne la vitesse de lecture normale, en images par seconde, pour l’appareil.
nombre de marques	Retourne le nombre maximal de marques pouvant être utilisées ; zéro indique que les marques ne sont pas prises en charge.
outputs	Retourne le nombre total d’appareils de sortie.
rechercher la précision	Retourne la précision attendue d’une recherche dans des cadres ; 0 indique que l’appareil est précis, 1 indique que l’appareil s’attend à se trouver dans un cadre de la position de recherche indiquée, et ainsi de suite.
taux de lecture lent	Retourne le taux de lecture lent en images par seconde, ou zéro si l’appareil ne peut pas être lu lentement.
utilise des fichiers	Retourne TRUE si le stockage de données utilisé par un appareil composé est un fichier.
utilise des palettes	Retourne TRUE si l’appareil utilise des palettes.
windows	Retourne le nombre de fenêtres d’affichage simultanées que l’appareil peut prendre en charge.

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 Indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne des informations dans le paramètre lpszReturnString de la fonction mciSendString . Les informations dépendent du type de demande.

Exemples

La commande suivante retourne le type d’appareil de l’appareil « mysound ».

capability mysound device type

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

Indice