commande seek

La commande seek se déplace à la position spécifiée et s’arrête. Cd audio, digital-video, séquenceur MIDI, magnétoscope, vidéodisc et les appareils 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("seek %s %s %s"), 
  lpszDeviceID, 
  lpszSeekFlags, 
  lpszFlags
); 

Paramètres

lpszDeviceID

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

lpszSeekFlags

Indicateur de déplacement vers une position spécifiée. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande seek et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
cdaudio	pour terminer à la position	pour démarrer
digitalvideo	pour terminer à la position	pour démarrer
sequencer	pour terminer à la position	pour démarrer
Magnétoscope	au momentde marquer mark_numinverse	pour se terminer à la positionde début
vidéodisc	inverser à la fin	pour la positionde démarrage
waveaudio	pour terminer à la position	pour démarrer

Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszSeekFlags 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 .
marquer mark_num	Recherche la marque relative indiquée par mark_num, qui doit être une valeur entière positive. Les marques sont des signaux écrits sur la bande VCR à l’aide de la commande mark et sont utilisés pour la recherche à grande vitesse.
reverse	Indique que la direction de recherche sur les magnétoscopes et les vidéodiscS CAV est descendante. Cet indicateur n’est pas valide si l’indicateur « à » est spécifié. Pour les magnétoscopes, cet indicateur doit être utilisé avec l’indicateur « mark ».
pour terminer	Recherche jusqu’à la fin du contenu.
à positionner	Spécifie la position pour arrêter la recherche. Pour les appareils cdaudio , MCI retourne une erreur hors plage si la position spécifiée est supérieure à la longueur du disque.
pour démarrer	Recherche le début du contenu.

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 .

Les appareils vidéo numériques prennent en charge deux modes de recherche, que vous pouvez modifier à l’aide de la commande set . Le mode « rechercher exactement activé » entraîne le déplacement de la commande seek vers le cadre spécifié. Le mode « rechercher exactement désactivé » entraîne le déplacement de la commande seek vers l’image clé la plus proche avant l’image spécifiée.

Si un périphérique audio CD est lu lors de l’émission de la commande seek, la lecture est arrêtée. Lorsque la commande seek est émise avec un appareil videodisc, l’appareil effectue des recherches à l’aide de l’avance rapide ou de l’inverse rapide avec la vidéo et l’audio désactivés.

Lorsque la commande seek est émise avec un appareil audio de forme d’onde, le comportement dépend de la taille de l’exemple. Si la taille de l’exemple est supérieure ou égale à 16 bits, la recherche se déplace au début de l’exemple le plus proche lorsqu’une position spécifiée ne coïncide pas avec le début d’un exemple.

Exemples

La commande suivante recherche le début du fichier multimédia associé à l’appareil « mysound ».

seek mysound to start

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

mark

set