Commande MCI_LIST
La commande MCI_LIST obtient des informations sur le nombre et les types d’entrées disponibles pour l’appareil. Les appareils vidéo numériques et les magnétoscopes reconnaissent cette commande.
Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_LIST,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpList
);
Paramètres
-
wDeviceID
-
Identificateur de l’appareil MCI qui doit recevoir le message de commande.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs Wait, Notify et Test.
-
lpList
-
Pointeur vers une structure MCI_GENERIC_PARMS. (Les appareils avec des jeux de commandes étendus peuvent remplacer cette structure par une structure spécifique à l’appareil.)
Valeur de retour
Retourne une valeur nulle en cas de réussite ou une erreur dans le cas contraire.
Notes
Les indicateurs supplémentaires suivants s’appliquent au type d’appareil digitalvideo :
-
MCI_DGV_LIST_ALG
-
Le membre lpstrAlgorithm de la structure identifiée par lpList contient l’adresse d’une mémoire tampon contenant le nom d’un algorithme. Le nom est utilisé pour récupérer les types de descripteurs de qualité associés à un algorithme.
-
MCI_DGV_LIST_COUNT
-
Retourne le nombre d’options du type spécifié.
-
MCI_DGV_LIST_ITEM
-
Constante indiquant que le type de liste est inclus dans le membre dwItem de la structure identifiée par lpList. Cet indicateur est obligatoire. Utilisez l’une des constantes suivantes pour indiquer le type de liste :
-
MCI_DGV_LIST_AUDIO_ALG
-
La commande doit récupérer les noms des algorithmes audio.
-
MCI_DGV_LIST_AUDIO_QUALITY
-
La commande doit récupérer les niveaux de qualité audio. Les niveaux retournés sont associés à l’algorithme référencé par le membre lpstrAlgorithm de la structure identifiée par lpList. Si ce membre est spécifié à l’aide de la chaîne « current », les qualités associées à l’algorithme actuel sont retournées.
-
MCI_DGV_LIST_AUDIO_STREAM
-
La commande doit récupérer les noms des flux audio.
-
MCI_DGV_LIST_STILL_AL
-
La commande doit récupérer les noms des algorithmes d’image fixe.
-
MCI_DGV_LIST_STILL_QUALITY
-
La commande doit récupérer les niveaux de qualité. Les niveaux retournés sont associés à l’algorithme référencé par le membre lpstrAlgorithm de la structure identifiée par lpList. Si ce membre est spécifié à l’aide de la chaîne « current », les qualités associées à l’algorithme actuel sont retournées.
-
MCI_DGV_LIST_VIDEO_ALG
-
La commande doit récupérer les noms des algorithmes vidéo.
-
MCI_DGV_LIST_VIDEO_QUALITY
-
La commande doit récupérer les niveaux de qualité vidéo. Les niveaux retournés sont associés à l’algorithme référencé par le membre lpstrAlgorithm de la structure identifiée par lpList. Si ce membre est spécifié à l’aide de la chaîne « current », les qualités associées à l’algorithme actuel sont retournées.
-
MCI_DGV_LIST_VIDEO_SOURCE
-
La commande doit retourner des informations sur les sources vidéo. Lorsqu’elle est utilisée avec MCI_DGV_LIST_COUNT, la commande retourne le nombre de sources vidéo. Lorsqu’elle est utilisée avec MCI_DGV_LIST_NUMBER, la commande retourne le type d’une source vidéo. MCI définit les types suivants :
- MCI_DGV_SETVIDEO_SRC_GENERIC
- MCI_DGV_SETVIDEO_SRC_NTSC
- MCI_DGV_SETVIDEO_SRC_PAL
- MCI_DGV_SETVIDEO_SRC_RGB
- MCI_DGV_SETVIDEO_SRC_SECAM
- MCI_DGV_SETVIDEO_SRC_SVIDEO
Plusieurs sources de chaque type peuvent être retournées. Le type de source « generic » est utilisé lorsque plusieurs types de signaux sont autorisés pour ce connecteur.
-
MCI_DGV_LIST_VIDEO_STREAM
-
La commande doit récupérer les noms des flux vidéo.
-
MCI_DGV_LIST_NUMBER
-
Un index est spécifié dans le membre dwNumber de la structure identifiée par lpList. L’index doit être un entier compris entre 1 et la valeur retournée pour l’indicateur MCI_DGV_LIST_COUNT.
Pour les appareils vidéo numériques, lpList pointe vers une structure MCI_DGV_LIST_PARMS.
Les indicateurs supplémentaires suivants s’appliquent au type d’appareil vcr :
-
MCI_VCR_LIST_AUDIO_SOURCE
-
Répertorie les entrées ou types d’entrées audio.
-
MCI_VCR_LIST_COUNT
-
Définit le membre dwReturn de la structure identifiée par lpList sur le nombre total d’entrées vidéo ou audio.
-
MCI_VCR_LIST_NUMBER
-
Définit le membre dwReturn de la structure identifiée par lpList sur le type d’entrée vidéo ou audio spécifiée par le membre dwNumber.
-
MCI_VCR_LIST_VIDEO_SOURCE
-
Répertorie les entrées ou types d’entrées vidéo.
Pour les magnétoscopes, lpList pointe vers une structure MCI_VCR_LIST_PARMS.
Configuration requise
| Condition requise | Value |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|