Partager via


Commande list

La commande list détermine le nombre et les types d’entrées vidéo et audio. Les appareils de vidéo numérique et de magnétoscope reconnaissent cette commande.

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

_stprintf_s(
  lpszCommand, 
  TEXT("list %s %s %s"), 
  lpszDeviceID, 
  lpszList, 
  lpszFlags
); 

Paramètres

lpszDeviceID

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

lpszList

Indicateur qui identifie le nombre et les types d’entrées vidéo et audio. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande list et les indicateurs utilisés par chaque type.

Valeur Signification Signification
digitalvideo algorithme audioaudio algorithme de qualité algorithmeaudio streamcountnumber index still algorithmstill algorithme de qualité algorithme algorithmevideo algorithmvidéo algorithme de qualité algorithmede qualité algorithme source vidéovidé stream vidéo
Magnétoscope index de numéro de source de la source audio countaudio video source countvideo source number index

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

Valeur Signification
algorithme audio Spécifie que la commande doit récupérer les noms d’algorithmes audio.
algorithme de qualité audio Spécifie que la commande doit récupérer les niveaux de qualité associés à l’algorithme spécifié. Si l’algorithme est « actuel », le niveau de qualité de l’algorithme actuel est retourné.
nombre de sources audio Retourne le nombre total d’entrées audio.
index de numéro de source audio Retourne le type d’entrée audio de l’index source.
flux audio Spécifie que la commande doit récupérer les noms des flux audio associés à l’espace de travail. Ces chaînes (telles que « Anglais » ou « Allemand ») sont incorporées dans le fichier et identifient le flux.
count Retourne le nombre d’options du type spécifié.
index numérique Renvoie une chaîne décrivant une option spécifique (identifiée par l’index) du type d’option spécifié. Index doit être un entier compris entre 1 et la valeur retournée par « count ».
algorithme still Spécifie que la commande doit récupérer les noms d’algorithmes immobiles.
algorithme de qualité still Spécifie que la commande doit récupérer les niveaux de qualité associés à l’algorithme still spécifié. Si l’algorithme est « actuel », le niveau de qualité de l’algorithme actuel est retourné.
algorithme vidéo Spécifie que la commande doit récupérer les noms d’algorithmes vidéo.
algorithme de qualité vidéo Spécifie que la commande doit récupérer les niveaux de qualité associés à l’algorithme vidéo spécifié. Si l’algorithme est « actuel », le niveau de qualité de l’algorithme actuel est retourné.
source vidéo Spécifie que la commande doit retourner des informations sur les sources vidéo. Lorsqu’il est utilisé avec l’indicateur « count », il retourne le nombre de sources vidéo. Lorsqu’il est utilisé avec l’indicateur « nombre », il retourne le type d’une source vidéo. MCI définit les constantes suivantes pour le type : « ntsc », « rgb », « pal », « secam », « svideo » et « generic ». Plusieurs sources de chaque type peuvent être retournées. Le type de source « générique » est utilisé lorsque plusieurs signaux sont autorisés pour ce connecteur.
nombre de sources vidéo Retourne le nombre total d’entrées vidéo.
index de numéro de source vidéo Retourne le type d’entrée vidéo de l’index source.
flux vidéo Spécifie que la commande doit récupérer les noms des flux vidéo associés à l’espace de travail. Ces chaînes (telles que « fin drôle » ou « fin triste ») sont incorporées dans le fichier et identifient le flux.

lpszFlags

Peut être « wait », « notify » ou « test ». Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Valeur renvoyée

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

Notes

Pour les appareils vcR, « source vidéo » ou « source audio » doivent être spécifiés avec les indicateurs « count » ou « number ». Si « count » est spécifié, le nombre total d’entrées vidéo ou audio est retourné. Si « number » est spécifié, le pilote retourne un type correspondant à l’entrée. Le type peut être l’un des éléments suivants : « tuner », « line », « svideo », « aux » ou « generic ». En règle générale, vous devez d’abord interroger le magnétoscope pour le « nombre », puis utiliser le nombre comme plage pour l’indicateur « nombre ». Les nombres « source » commencent à partir de 1.

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