Partager via


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