comando play

El comando play comienza a reproducir un dispositivo. Los dispositivos cd audio, digital-video, secuenciador MIDI, videodisc, VCR y audio de forma de onda reconocen este comando.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

_stprintf_s(
  lpszCommand, 
  TEXT("play %s %s %s"), 
  lpszDeviceID, 
  lpszPlayFlags, 
  lpszFlags
); 

Parámetros

lpszDeviceID

Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.

lpszPlayFlags

Marca para reproducir un dispositivo. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando play y las marcas usadas por cada tipo.

Valor Significado Significado
cdaudio desde la posición para colocar
digitalvideo desde la posiciónde repetición de pantalla completa invertir en la ventana de posición
sequencer desde la posición para colocar
Vcr a la vezdesde la posicióninversa examinar a la posición
Videodisco rápido desde el examen inverso de posición entero de velocidadlenta que se va a colocar
waveaudio desde la posición para colocar

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszPlayFlags y sus significados.

Valor Significado
a la vez Indica cuándo debe comenzar el dispositivo a realizar este comando, o bien, si el dispositivo se ha cued, cuando comienza el comando cued. Para obtener más información, consulte el comando cue .
fast Indica que el dispositivo debe reproducirse más rápido de lo normal. Para determinar la velocidad exacta en un reproductor de videodisc, use la marca "speed" del comando status . Para especificar la velocidad más precisamente, use la marca "speed" de este comando.
desde la posición Especifica una posición inicial para la reproducción. Si no se especifica la marca "from", la reproducción comienza en la posición actual. En el caso de los dispositivos cdaudio , si la posición "from" es mayor que la posición final del disco, o si la posición "from" es mayor que la posición "to", el controlador devuelve un error. En el caso de los dispositivos de videodisc , las posiciones predeterminadas están en fotogramas para discos CAV y en horas, minutos y segundos para los discos CLV.
Fullscreen Especifica que se debe usar una pantalla de pantalla completa. Use esta marca solo al reproducir archivos comprimidos. (Los archivos sin comprimir no reproducirán la pantalla completa).
repeat Especifica que la reproducción debe reiniciarse cuando se alcanza el final del contenido.
reverse Especifica que la dirección de reproducción está hacia atrás. No se puede especificar una ubicación final con la marca "inversa". En el caso de videodiscs, "scan" solo se aplica al formato CAV.
scan Reproduce lo más rápido posible sin deshabilitar el vídeo (aunque es posible que el audio esté deshabilitado). En el caso de videodiscs, "scan" solo se aplica al formato CAV.
lento Se reproduce lentamente. Para determinar la velocidad exacta en un reproductor de videodisc, use la marca "speed" del comando status . Para especificar la velocidad más precisamente, use la marca "speed" de este comando. En el caso de las videodiscs, "lento" solo se aplica al formato CAV.
entero de velocidad Reproduce un videodisc a la velocidad especificada, en fotogramas por segundo. Esta marca solo se aplica a los discos CAV.
para colocar Especifica una posición final para la reproducción. Si no se especifica la marca "to", la reproducción se detiene al final del contenido. En el caso de los dispositivos cdaudio , si la posición "a" es mayor que la posición final del disco, el controlador devuelve un error. En el caso de los dispositivos de videodisc , las posiciones predeterminadas están en fotogramas para discos CAV y en horas, minutos y segundos para los discos CLV.
periodo Especifica que la reproducción debe usar la ventana asociada a la instancia del dispositivo. Esta es la configuración predeterminada.

lpszFlags

Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital y VCR, también se puede especificar "test". Para obtener más información sobre estas marcas, vea Las marcas Wait, Notify y Test.

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo contrario.

Comentarios

Antes de emitir comandos que usen valores de posición, debe establecer el formato de hora deseado mediante el comando set . Este comando comienza a reproducirse a la velocidad actual, como se establece con el comando set "speed". La dirección es inversa si se especifica la marca "reverse" o si la marca "to" se especifica como un valor menor que la marca "from". Si no se especifica la marca "from", la reproducción comienza en la posición actual. Las marcas "to" y "reverse" no se pueden usar juntas.

Ejemplos

El siguiente comando reproduce el dispositivo "mysound" desde la posición 1000 hasta la posición 2000, enviando un mensaje de notificación cuando se completa la reproducción.

play mysound from 1000 to 2000 notify

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]

Consulte también

MCI

Cadenas de comandos de MCI

Cue

set