commande MCI_CUE

Article
06/13/2023

La commande MCI_CUE indique un appareil afin que la lecture ou l’enregistrement commence avec un délai minimal. Les appareils de vidéo numérique, de magnétoscope et d’audio de formes d’ondes reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_CUE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpCue
);

Paramètres

wDeviceID: Identificateur de l’appareil MCI devant recevoir le message de commande.
dwFlags: MCI_NOTIFY, MCI_WAIT ou, pour les appareils de vidéo numérique et de magnétoscope, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.
lpCue: 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 renvoyée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire.

Notes

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil digitalvideo :

MCI_DGV_CUE_INPUT: Un instance vidéo numérique doit se préparer à l’enregistrement. Si l’application n’a pas réservé d’espace disque, l’appareil réserve l’espace disque à l’aide de ses paramètres par défaut. L’application peut omettre cet indicateur si la source de présentation actuelle est déjà l’entrée externe. (Cet indicateur n’a aucun effet sur la sélection de la source de présentation.)
MCI_DGV_CUE_NOSHOW: Un instance vidéo numérique doit se préparer à lire le frame spécifié avec la commande sans l’afficher. Lorsque cet indicateur est spécifié, l’affichage continue d’afficher l’image dans la mémoire tampon du frame, même si son image correspondante n’est pas la position actuelle. Par exemple, si la mémoire tampon de trame contient l’image de l’image de l’image 7, l’appareil continue d’afficher l’image 7 lorsque cet indicateur est utilisé pour indiquer à l’appareil une autre position. Une commande d’indicateur suivante sans cet indicateur et sans l’indicateur MCI_TO affiche le cadre actuel.
MCI_DGV_CUE_OUTPUT: Un instance vidéo numérique doit se préparer à la lecture. Si l’espace de travail est suspendu, aucun positionnement n’est effectué. Si l’espace de travail est arrêté, la position peut passer à une image de cadre clé précédente. L’application peut omettre cet indicateur si la source de présentation actuelle est déjà l’espace de travail.
MCI_TO: Une position d’espace de travail est incluse dans le membre dwTo de la structure identifiée par lpCue. Les unités affectées aux valeurs de position sont spécifiées à l’aide de l’indicateur MCI_SET_TIME_FORMAT de la commande MCI_SET . Cela revient à rechercher une position, sauf que l’appareil est suspendu après la commande.

Pour les appareils digitalvideo , le paramètre lpCue pointe vers une structure MCI_DGV_CUE_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil vcr :

MCI_FROM: Le membre dwFrom de la structure pointée par lpCue contient l’emplacement de départ spécifié dans le format d’heure actuel.
MCI_TO: Le membre dwTo de la structure pointée par lpCue contient l’emplacement de fin (pause) spécifié dans le format d’heure actuel.
MCI_VCR_CUE_INPUT: Préparer l’enregistrement.
MCI_VCR_CUE_OUTPUT: Préparez-vous à jouer. Si ni MCI_VCR_CUE_INPUT ni MCI_VCR_CUE_OUTPUT n’est spécifié, MCI_VCR_CUE_OUTPUT est supposé.
MCI_VCR_CUE_PREROLL: Indiquez l’appareil à la position actuelle, ou à la position dwFrom , moins la durée de pré-inscription. Cela permet à l’appareil de se préparer avant d’entrer en mode enregistrement ou lecture.
MCI_VCR_CUE_REVERSE: La direction de la commande de lecture ou d’enregistrement suivante est inversée.

Lorsque vous indiquez la lecture à l’aide de la commande MCI_CUE avec l’indicateur MCI_VCR_CUE_OUTPUT, vous pouvez annuler MCI_CUE en émettant la commande MCI_PLAY avec MCI_FROM, MCI_TO ou MCI_VCR_PLAY_REVERSE.

Lorsque vous signalez l’enregistrement à l’aide de MCI_CUE avec l’indicateur MCI_VCR_CUE_INPUT, vous pouvez annuler MCI_CUE en émettant la commande MCI_RECORD avec MCI_FROM, MCI_TO ou MCI_VCR_RECORD_INITIALIZE.

Pour les appareils vcr , le paramètre lpCue pointe vers une structure MCI_VCR_CUE_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil waveaudio :

MCI_WAVE_INPUT: Un périphérique d’entrée audio de forme d’onde doit être cueded.
MCI_WAVE_OUTPUT: Un périphérique de sortie audio de forme d’onde doit être cueded. Il s’agit de l’indicateur par défaut si aucun indicateur n’est spécifié.

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]
En-tête	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI
Commandes MCI

Partager via