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	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI