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