commande MCI_PLAY

Article
06/13/2023

La commande MCI_PLAY indique à l’appareil de commencer à transmettre les données de sortie. Les périphériques audio CD, digital-video, séquenceur MIDI, videodisc, VCR et waveform-audio reconnaissent cette commande.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PLAY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_PLAY_PARMS ) lpPlay
);

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.
lpPlay: Pointeur vers une structure MCI_PLAY_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 s’appliquent à tous les appareils prenant en charge MCI_PLAY :

MCI_FROM: Un emplacement de départ est inclus dans le membre dwFrom de la structure identifiée par lpPlay. 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 . Si MCI_FROM n’est pas spécifié, l’emplacement de départ est défini par défaut sur la position actuelle.
MCI_TO: Un emplacement de fin est inclus dans le membre dwTo de la structure identifiée par lpPlay. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de MCI_SET. Si MCI_TO n’est pas spécifié, l’emplacement de fin est défini par défaut sur la fin du média.

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

MCI_DGV_PLAY_REPEAT: La lecture doit recommencer au début lorsque la fin du contenu est atteinte.
MCI_DGV_PLAY_REVERSE: La lecture doit se produire à l’envers.
MCI_MCIAVI_PLAY_WINDOW: La lecture doit se produire dans la fenêtre associée à un appareil instance (valeur par défaut). (Cet indicateur est spécifique à MCIAVI. DRV.)
MCI_MCIAVI_PLAY_FULLSCREEN: La lecture doit utiliser un affichage en plein écran. Utilisez cet indicateur uniquement lors de la lecture de fichiers compressés ou 8 bits.

Pour les appareils vidéo numériques, lpPlay pointe vers une structure MCI_DGV_PLAY_PARMS .

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

MCI_VCR_PLAY_AT: Le membre dwAt de la structure identifiée par lpPlay contient une heure à laquelle la commande entière commence, ou si l’appareil est cuedé, lorsque l’appareil atteint la position de départ donnée par la commande MCI_CUE .
MCI_VCR_PLAY_REVERSE: La lecture doit se produire à l’envers.
MCI_VCR_PLAY_SCAN: La lecture doit être aussi rapide que possible tout en conservant la sortie vidéo.

Pour les appareils VCR, lpPlay pointe vers une structure MCI_VCR_PLAY_PARMS .

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

MCI_VD_PLAY_FAST: Jouez vite.
MCI_VD_PLAY_REVERSE: Jouer à l’envers.
MCI_VD_PLAY_SCAN: Analysez rapidement.
MCI_VD_PLAY_SLOW: Jouez lentement.
MCI_VD_PLAY_SPEED: La vitesse de lecture est incluse dans le membre dwSpeed dans la structure identifiée par lpPlay.

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