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] |