Partager via


commande cue

La commande cue se prépare à la lecture ou à l’enregistrement. Les appareils de vidéo numérique, de magnétoscope et d’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("cue %s %s %s"), 
  lpszDeviceID, 
  lpszInOutTo, 
  lpszFlags
); 

Paramètres

lpszDeviceID

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

lpszInOutTo

Indicateur qui prépare un appareil pour la lecture ou l’enregistrement. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande cue et les indicateurs utilisés par chaque type.

Valeur Signal Signal
digitalvideo
  • entrée
  • noshow
  • sortie
  • à positionner
Magnétoscope
  • à partir de la position
  • entrée
  • sortie
  • préroll
  • reverse
  • à positionner
waveaudio entrée sortie

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

Valeur Signification
à partir de la position Indique par où commencer.
entrée Prépare l’enregistrement. Pour les appareils vidéo numériques, cet indicateur peut être omis si la source de présentation actuelle est déjà l’entrée externe.
noshow Prépare la lecture d’un cadre sans l’afficher. Lorsque cet indicateur est spécifié, l’affichage continue d’afficher l’image dans la mémoire tampon d’image même si son image correspondante n’est pas la position actuelle. Une commande de signal suivante sans cet indicateur et sans l’indicateur « à » affiche le cadre actuel.
sortie Se prépare à jouer. Si ni « input » ni « output » n’est spécifié, le paramètre par défaut est « output ».
préroll Déplace la distance du préroll par rapport au point de départ. Le point in est la position actuelle, ou la position spécifiée par l’indicateur « from ».
reverse Indique que le sens de lecture est inversé (vers l’arrière).
à positionner Déplace l’espace de travail à la position spécifiée. Pour les appareils vcR, cet indicateur indique où s’arrêter.

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

Bien que cela ne soit pas nécessaire, l’émission de la commande de signal avant la lecture ou l’enregistrement sur certains appareils peut réduire le délai avant que l’appareil ne démarre l’action.

Cette commande échoue si la lecture ou l’enregistrement est en cours ou si l’appareil est suspendu.

Lorsque vous indiquez la lecture (à l’aide du signal « output »), l’émission de la commande play avec l’indicateur « from », « to » ou « reverse » annule la commande cue.

Lors de l’enregistrement (à l’aide du signal « entrée »), l’émission de la commande d’enregistrement avec l’indicateur « from », « to » ou « initialize » annule la commande cue.

Exemples

La commande suivante prépare l’appareil « mysound » pour l’enregistrement.

cue mysound input

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

play

enregistrement