fonctionnalité, commande

La commande Capability demande des informations sur une capacité particulière d’un appareil. Tous les périphériques 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 attribué lorsque l’appareil est ouvert.

lpszRequest

Indicateur qui identifie une fonctionnalité de l’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 geler
  • verrouillage possible
  • peut jouer
  • peut enregistrer
  • peut inverser
  • peut enregistrer
  • peut étirer
  • peut étirer l’entrée
  • test possible
  • appareil composé
  • type de périphérique
  • a de l’audio
  • a toujours
  • a une vidéo
  • taux de lecture maximal
  • Vitesse de lecture minimale
  • utilise des fichiers
  • utilise des palettes
  • windows
superposition
  • peut éjecter
  • peut geler
  • peut jouer
  • peut enregistrer
  • peut enregistrer
  • peut é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
vidéo
  • peut détecter une longueur
  • peut éjecter
  • peut geler
  • peut surveiller les sources
  • peut jouer
  • peut être préroll
  • peut afficher un aperçu
  • peut enregistrer
  • peut inverser
  • peut enregistrer
  • test possible
  • taux d’incrément d’horloge
  • appareil composé
  • type de périphérique
  • a de l’audio
  • a une horloge
  • a un code temporel
  • a une vidéo
  • nombre de marques
  • précision de la recherche
  • 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 lecture 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 une longueur Retourne la valeur true si l’appareil peut détecter la longueur du média.
peut éjecter Retourne la valeur true si l’appareil peut éjecter le média.
peut geler Retourne la valeur true si l’appareil peut geler des données dans la mémoire tampon de trame.
verrouillage possible Retourne la valeur true si l’appareil peut verrouiller les données.
peut surveiller les sources Retourne la valeur true si l’appareil peut passer une entrée (source) à la sortie analysée, indépendamment de la sélection d’entrée actuelle.
peut jouer Retourne la valeur true si l’appareil peut jouer.
peut être préroll Retourne la valeur true si l’appareil prend en charge l’indicateur de préroll avec la commande CUE .
peut afficher un aperçu Retourne la valeur true si l’appareil prend en charge les aperçus.
peut enregistrer Retourne la valeur true si l’appareil prend en charge l’enregistrement.
peut inverser Retourne la valeur true si l’appareil peut jouer en sens inverse.
peut enregistrer Retourne la valeur true si l’appareil peut enregistrer des données.
peut étirer Retourne la valeur true si l’appareil peut étirer des frames pour remplir un rectangle d’affichage donné.
peut étirer l’entrée Retourne la valeur true si l’appareil peut redimensionner une image dans le processus de sa numérisation dans la mémoire tampon de trame.
test possible Retourne la valeur true si l’appareil reconnaît le mot clé test.
cav Lorsqu’il est combiné à d’autres éléments, cet indicateur spécifie que les informations de retour s’appliquent au format CAV videodiscs. Il s’agit de la valeur par défaut si aucun videodisc n’est inséré.
taux d’incrément d’horloge Retourne le nombre de sous-cloisonnements pris en charge par l’horloge externe 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é à d’autres éléments, cet indicateur spécifie que les informations de retour s’appliquent au format CLV videodiscs.
appareil composé Retourne la valeur true si l’appareil prend en charge un nom d’élément (fileName).
type de périphérique Retourne un nom de type d’appareil, qui peut être l’un des éléments suivants :
  • cdaudio
  • anciens
  • digitalvideo
  • other
  • superposition
  • scanneur
  • sequencer
  • vidéo
  • 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 être lu rapidement.
a de l’audio Retourne la valeur true si l’appareil prend en charge la lecture audio.
a une horloge Retourne la valeur true si l’appareil a une horloge.
a toujours Retourne la valeur true si l’appareil traite les fichiers avec une seule image plus efficacement que les fichiers vidéo animés.
a un code temporel Retourne la valeur true si l’appareil est en capacité de prendre en charge le code temporel, ou s’il est inconnu.
a une vidéo Retourne la valeur true si l’appareil prend en charge la vidéo.
inputs Retourne le nombre total de périphériques d’entrée.
taux de lecture maximal Retourne la vitesse de lecture maximale, en images par seconde, pour l’appareil.
Vitesse de lecture minimale Retourne la vitesse de lecture minimale, en images par seconde, pour l’appareil.
taux de lecture normal Retourne la vitesse de lecture normale, en images par seconde, pour l’appareil.
nombre de marques Retourne le nombre maximal de marques qui peuvent être utilisées ; la valeur zéro indique que les marques ne sont pas prises en charge.
outputs Retourne le nombre total de périphériques de sortie.
précision de la recherche Retourne la précision attendue d’une recherche dans les frames ; 0 indique que l’appareil est correct, 1 indique que l’appareil s’attend à se trouver dans une trame 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 fonctionner lentement.
utilise des fichiers Retourne la valeur true si le stockage de données utilisé par un périphérique composé est un fichier.
utilise des palettes Retourne la valeur 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 « Wait », « Notify », ou les deux. Pour les appareils vidéo numériques et VCR, vous pouvez également spécifier « test ». 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 la fonction mciSendString . Les informations dépendent du type de demande.

Exemples

La commande suivante retourne le type de périphérique 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

signal