comando play
O comando play começa a reproduzir um dispositivo. Os dispositivos de áudio de CD, vídeo digital, sequenciador MIDI, videodisc, VCR e waveform-audio reconhecem esse comando.
Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.
_stprintf_s(
lpszCommand,
TEXT("play %s %s %s"),
lpszDeviceID,
lpszPlayFlags,
lpszFlags
);
Parâmetros
-
lpszDeviceID
-
Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.
-
lpszPlayFlags
-
Sinalizador para reproduzir um dispositivo. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando play e os sinalizadores usados por cada tipo.
Valor Significado Significado cdaudio da posição para posicionar digitalvideo da posiçãode repetição de tela inteira inverter para a janela de posição sequenciador da posição para posicionar Videocassete no momentoda posiçãoinversa verificar para posicionar videodisc verificação inversa rápida da posição número inteirode velocidade lenta para posicionar Waveaudio da posição para posicionar A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszPlayFlags e seus significados.
Valor Significado no momento Indica quando o dispositivo deve começar a executar esse comando ou, se o dispositivo tiver sido atualizado, quando o comando cued for iniciado. Para obter mais informações, consulte o comando de indicação . rápido Indica que o dispositivo deve ser reproduzido mais rápido do que o normal. Para determinar a velocidade exata em um player videodisc, use o sinalizador "speed" do comando status. Para especificar a velocidade com mais precisão, use o sinalizador de "velocidade" desse comando. da posição Especifica uma posição inicial para a reprodução. Se o sinalizador "from" não for especificado, a reprodução começará na posição atual. Para dispositivos cdaudio , se a posição "from" for maior que a posição final do disco ou se a posição "from" for maior que a posição "to", o driver retornará um erro. Para dispositivos videodisc , as posições padrão estão em quadros para discos CAV e em horas, minutos e segundos para discos CLV. tela inteira Especifica que uma tela inteira deve ser usada. Use esse sinalizador somente ao reproduzir arquivos compactados. (Arquivos descompactados não serão reproduzidos em tela inteira.) repeat Especifica que a reprodução deve ser reiniciada quando o final do conteúdo for atingido. reverse Especifica que a direção da reprodução é para trás. Não é possível especificar um local final com o sinalizador "inverso". Para videodiscs, "scan" aplica-se somente ao formato CAV. verificar Reproduz o mais rápido possível sem desabilitar o vídeo (embora o áudio possa estar desabilitado). Para videodiscs, "scan" aplica-se somente ao formato CAV. lento Joga devagar. Para determinar a velocidade exata em um player videodisc, use o sinalizador "speed" do comando status. Para especificar a velocidade com mais precisão, use o sinalizador de "velocidade" desse comando. Para videodiscs, "lento" aplica-se somente ao formato CAV. número inteiro de velocidade Reproduz um videodisc na velocidade especificada, em quadros por segundo. Esse sinalizador se aplica somente a discos CAV. para posicionar Especifica uma posição final para a reprodução. Se o sinalizador "para" não for especificado, a reprodução será interrompida no final do conteúdo. Para dispositivos cdaudio , se a posição "to" for maior que a posição final do disco, o driver retornará um erro. Para dispositivos videodisc , as posições padrão estão em quadros para discos CAV e em horas, minutos e segundos para discos CLV. janela Especifica que a reprodução deve usar a janela associada à instância do dispositivo. Essa é a configuração padrão. -
lpszFlags
-
Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital e VCR, "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
Antes de emitir comandos que usam valores de posição, você deve definir o formato de hora desejado usando o comando set . Esse comando começa a ser reproduzido na velocidade atual, conforme definido com o comando "speed" definido. A direção será inversa se o sinalizador "inverso" for especificado ou se o sinalizador "to" for especificado como um valor menor que o sinalizador "from". Se o sinalizador "from" não for especificado, a reprodução começará na posição atual. Os sinalizadores "para" e "inverter" não podem ser usados juntos.
Exemplos
O comando a seguir reproduz o dispositivo "mysound" da posição 1000 até a posição 2000, enviando uma mensagem de notificação quando a reprodução é concluída.
play mysound from 1000 to 2000 notify
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |