commande play

La commande play démarre la lecture d’un appareil. Les appareils audio CD, digital-video, séquenceur MIDI, vidéodisc, magnétoscope et audio de forme d’onde reconnaissent cette commande.

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

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

Paramètres

lpszDeviceID

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

lpszPlayFlags

Indicateur de lecture d’un appareil. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande play et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
cdaudio	à partir de la position	à positionner
digitalvideo	à partir de la positionde répétition plein écran	fenêtre reverse to position
sequencer	à partir de la position	à positionner
Magnétoscope	à partirde la positioninversée au moment	analyser pour se positionner
vidéodisc	rapide à partir de l’analyse inverse de position	entierà vitesse lente à positionner
waveaudio	à partir de la position	à positionner

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

Valeur	Signification
à l’heure	Indique quand l’appareil doit commencer à exécuter cette commande ou, si l’appareil a été cued, quand la commande cued commence. Pour plus d’informations, consultez la commande cue .
fast	Indique que l’appareil doit être lu plus rapidement que d’habitude. Pour déterminer la vitesse exacte d’un lecteur vidéodisc, utilisez l’indicateur « vitesse » de la commande status. Pour spécifier la vitesse plus précisément, utilisez l’indicateur « vitesse » de cette commande.
à partir de la position	Spécifie une position de départ pour la lecture. Si l’indicateur « de » n’est pas spécifié, la lecture commence à la position actuelle. Pour les appareils cdaudio , si la position « de » est supérieure à la position de fin du disque ou si la position « de » est supérieure à la position « à », le pilote retourne une erreur. Pour les appareils videodisc , les positions par défaut sont dans les images pour les disques CAV et en heures, minutes et secondes pour les disques CLV.
Fullscreen	Spécifie qu’un affichage en plein écran doit être utilisé. Utilisez cet indicateur uniquement lors de la lecture de fichiers compressés. (Les fichiers non compressés ne sont pas lues en plein écran.)
répéter	Spécifie que la lecture doit redémarrer lorsque la fin du contenu est atteinte.
reverse	Spécifie que le sens de lecture est arrière. Vous ne pouvez pas spécifier un emplacement de fin avec l’indicateur « inverse ». Pour les vidéodiscs, « analyse » s’applique uniquement au format CAV.
scan	Lit aussi rapidement que possible sans désactiver la vidéo (même si l’audio peut être désactivé). Pour les vidéodiscs, « analyse » s’applique uniquement au format CAV.
slow	Lit lentement. Pour déterminer la vitesse exacte d’un lecteur vidéodisc, utilisez l’indicateur « vitesse » de la commande status. Pour spécifier la vitesse plus précisément, utilisez l’indicateur « vitesse » de cette commande. Pour les vidéodiscs, « lent » s’applique uniquement au format CAV.
entier de vitesse	Lit un vidéodisc à la vitesse spécifiée, en images par seconde. Cet indicateur s’applique uniquement aux disques CAV.
à positionner	Spécifie une position de fin pour la lecture. Si l’indicateur « à » n’est pas spécifié, la lecture s’arrête à la fin du contenu. Pour les appareils cdaudio , si la position « à » est supérieure à la position de fin du disque, le pilote retourne une erreur. Pour les appareils videodisc , les positions par défaut sont dans les images pour les disques CAV et en heures, minutes et secondes pour les disques CLV.
window	Spécifie que la lecture doit utiliser la fenêtre associée à l’appareil instance. Il s'agit du paramètre par défaut.

lpszFlags

Peut être « attendre », « notifier » ou les deux. Pour les appareils de vidéo numérique et de magnétoscope, « test » peut également être spécifié. 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

Avant d’émettre des commandes qui utilisent des valeurs de position, vous devez définir le format de temps souhaité à l’aide de la commande set . Cette commande commence à jouer à la vitesse actuelle, comme défini avec la commande définie « speed ». La direction est inversée si l’indicateur « inverse » est spécifié ou si l’indicateur « à » est spécifié sous la forme d’une valeur inférieure à l’indicateur « from ». Si l’indicateur « de » n’est pas spécifié, la lecture commence à la position actuelle. Les indicateurs « à » et « inverse » ne peuvent pas être utilisés ensemble.

Exemples

La commande suivante lit l’appareil « mysound » de la position 1000 à la position 2000, envoyant un message de notification une fois la lecture terminée.

play mysound from 1000 to 2000 notify

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

Indice

set