Commande MCI_LIST

  • Article

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
Mmsystem.h (y compris Windows.h)

Voir aussi

MCI

Commandes MCI