commande MCI_SEEK
La commande MCI_SEEK modifie la position actuelle dans le contenu aussi rapidement que possible. La sortie vidéo et audio est désactivée pendant la recherche. Une fois la recherche terminée, l’appareil est arrêté. Les périphériques audio CD, digital-video, SÉQUENCE MIDI, VCR, videodisc et waveform-audio reconnaissent cette commande.
Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SEEK,
DWORD dwFlags,
(DWORD) (LPMCI_SEEK_PARMS) lpSeek
);
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.
-
lpSeek
-
Pointeur vers une structure MCI_SEEK_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
Si une taille d’échantillon de données pour un appareil est supérieure à 1 octet (par exemple avec des données stéréo audio de forme d’onde), cette commande se déplace au début de l’échantillon le plus proche lorsqu’une position spécifiée ne coïncide pas avec le début d’un échantillon.
Les indicateurs supplémentaires suivants s’appliquent à tous les appareils prenant en charge MCI_SEEK :
-
MCI_SEEK_TO_END
-
Recherchez jusqu’à la fin du contenu.
-
MCI_SEEK_TO_START
-
Recherchez jusqu’au début du contenu.
-
MCI_TO
-
Une position est incluse dans le membre dwTo de la structure identifiée par lpSeek. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de la commande MCI_SET . N’utilisez pas cet indicateur avec MCI_SEEK_TO_END ou MCI_SEEK_TO_START.
Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil vcr :
-
MCI_VCR_SEEK_AT
-
Le membre dwAt de la structure identifiée par lpSeek contient une heure de début de la commande entière.
-
MCI_VCR_SEEK_MARK
-
Le membre dwMark de la structure identifiée par lpSeek contient la marque numérotée à rechercher.
-
MCI_VCR_SEEK_REVERSE
-
La direction de la recherche est inversée; il est utilisé uniquement avec l’indicateur MCI_VCR_SEEK_MARK.
Pour les appareils VCR, le paramètre lpSeek pointe vers une structure MCI_VCR_SEEK_PARMS .
L’indicateur supplémentaire suivant est utilisé avec le type d’appareil videodisc :
-
MCI_VD_SEEK_REVERSE
-
La direction de la recherche est inversée.
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 |
|