Comando setaudio
O comando setaudio define valores associados à reprodução e captura de áudio. Os dispositivos de vídeo digital e VCR 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("setaudio %s %s %s"),
lpszDeviceID,
lpszAudio,
lpszFlags
);
Parâmetros
-
lpszDeviceID
-
Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.
-
lpszAudio
-
Sinalizador para reprodução e captura de áudio. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando setaudio e os sinalizadores usados por cada tipo.
Valor Significado Significado digitalvideo alinhamento do algoritmo de algoritmocom baixo inteiropara fatorarbitspersample para bit_count bytespersec para entrada de clocktime inteirodeixada no volume esquerdo para fatorarna saída over durationquality descriptorrecord off record on right off right on right on right volume to factorsamplespersec to integersource to sourcenamestream to numbertreble to factorvolume to factor Videocassete off on monitor to typenumber numberrecord off record track track_number off registro na faixa de registro track_number na origem para digitar a faixanuméricatrack_number fora da faixa track_number em A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszAudio e seus significados.
Valor Significado algoritmo de algoritmo Seleciona um algoritmo de compactação de áudio específico para uso por um comando de reserva ou registro subsequente. Os algoritmos com suporte são específicos do dispositivo. MCI define os valores "g711", "g721", "g722", "g728", "pcm", "cdxa", "adpcm" e "adpcm4e" para algoritmo. Se um dispositivo der suporte aos nomes de algoritmo "pcm", "cdxa" e "adpcm4e", eles seguirão as definições padrão. O algoritmo "cdxa" foi definido pela Sony Corporation. O algoritmo "adpcm4e" foi definido pela Intel Corporation. Os valores "g711", "g721", "g722" e "g728" representam algoritmos de áudio recomendados pelo Comitê Consultivo Telefônico e Telegráfico Internacional (CCITT).
Se o algoritmo especificado entrar em conflito com o formato de arquivo atual, o formato do arquivo será alterado para o formato padrão do algoritmo.alinhamento ao inteiro Define o alinhamento dos blocos de dados em relação ao início dos dados de áudio de forma de onda de entrada. baixo para fator Define o nível de baixa frequência do áudio. bitspersample para bit_count Define o número de bits por amostra registrada. O arquivo é salvo nesse formato. Esse sinalizador se aplica somente a dispositivos que dão suporte ao algoritmo "pcm". bytespersec para inteiro Define o número médio de bytes por segundo para gravação nos algoritmos "pcm" e "adpcm". O arquivo é salvo nesse formato. clocktime Indica que o tempo especificado no sinalizador "over" está em milissegundos. Esse tempo é absoluto e não está em etapas com a reprodução do workspace. input Modifica o sinalizador "baixo", "agudo" ou "volume" para que ele afete o sinal de entrada e modifique o que é registrado. Se possível, esse é o padrão ao monitorar a entrada. parou para a esquerda em Habilita ou desabilita a saída de áudio no canal esquerdo. A origem da apresentação de áudio pode ser a entrada externa ou o workspace. O padrão é "left on". Se houver apenas um canal, esse canal será ativado ou desativado. volume à esquerda para fatorar Define o volume de áudio do canal de áudio esquerdo. Se houver apenas um canal, ele definirá seu volume. monitor para digitarnúmero de número Controla qual entrada de origem será passada para a saída do VCR sem alterar a seleção de entrada de origem de gravação. O tipo pode ser "output" ou uma das fontes de entrada válidas. Se number não for especificado, a primeira entrada desse tipo será escolhida. desativada Habilita ou desabilita o áudio. A origem da apresentação de áudio pode ser a entrada externa ou o workspace. Esse comando afeta os canais de áudio à esquerda e à direita simultaneamente. O padrão é setaudio "on". output Modifica o sinalizador "baixo", "agudo" ou "volume" para que ele modifique apenas o sinal reproduzido e não o que é gravado. Se possível, esse é o padrão ao monitorar um arquivo. ao longo da duração Especifica quanto tempo deve levar para fazer uma alteração que usa uma variável de fator . As unidades de duração estão no formato de hora atual. As alterações ocorrem em etapas com a reprodução do workspace. Quando o jogo é suspenso, a mudança também é suspensa até que a peça continue. Se "over" não for especificado ou não tiver suporte, a alteração ocorrerá imediatamente. descritor de qualidade Especifica as características da compactação de áudio executada quando o áudio é gravado em um arquivo. Todos os dispositivos dão suporte aos três descritores "baixo", "médio" e "alto". O padrão é específico do dispositivo. Se o sinalizador "algoritmo" não for especificado, o ajuste de "qualidade" se aplicará ao algoritmo atual.
O comando de qualidade pode ser usado para definir nomes de descritores adicionais.registro desativado Limpa a seleção de fonte de áudio para que nenhum áudio seja gravado com o próximo comando de registro . registro em Habilita a gravação de dados de áudio. O padrão é gravar dados de áudio. faixa de registro track_number desativada Limpa a seleção de fonte de áudio para que nenhum áudio seja gravado com o próximo comando de registro . "Track" permite a seleção de faixa independente. A faixa 2 corresponde à faixa pcm em Hi8. Se "track" não for especificado, um valor padrão de 1 será assumido. faixa de registro track_number em Seleciona a fonte de áudio a ser gravada com o próximo comando de registro . "Track" permite a seleção de faixa independente. A faixa 2 corresponde à faixa pcm em Hi8. Se "track" não for especificado, um valor padrão de 1 será assumido. desativada para a direita em Habilita ou desabilita a saída de áudio no canal direito. A origem da apresentação de áudio pode ser a entrada externa ou o workspace. O padrão é "right on". Se houver apenas um canal, esse sinalizador não terá efeito. volume certo para fatorar Define o volume de áudio para o canal de áudio à direita. Se houver apenas um canal, ele não terá efeito. samplespersec to integer Define a taxa de amostragem para gravação com os algoritmos "pcm" e "adpcm". O arquivo é salvo nesse formato. source to sourcename Especifica a origem do digitalizador de entrada de áudio. As constantes definidas para sourcename incluem: "left", "right", "average" e "stereo". Os três primeiros especificam a gravação monofônica usando apenas a entrada esquerda, a entrada à direita e a média das duas entradas. origem para digitarnúmero de número Seleciona a fonte de áudio a ser gravada na fita. O tipo deve ser "tuner", "line", "svideo", "aux", "generic" ou "mute". transmitir para número Especifica o fluxo de áudio reproduzido do workspace. Se o fluxo não for especificado e o formato de arquivo não definir um padrão, o fluxo de áudio intercalado que é fisicamente executado primeiro será reproduzido. acompanhar track_number desativado Desabilita uma faixa individual. acompanhar track_number em Habilita uma faixa individual. agudos para fator Define o nível de alta frequência de áudio. volume a fator Define o volume médio de áudio para ambos os canais de áudio. Se os volumes esquerdo e direito tiverem sido definidos como valores diferentes, a proporção do volume da esquerda para a direita será aproximadamente inalterada. -
lpszFlags
-
Pode ser "wait", "notify", "test" ou uma combinação deles. 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
Para dispositivos VCR, usar setaudio com um sinalizador que desativa uma faixa individual ("rastrear track_number desativado") pode fazer com que seu aplicativo receba uma mensagem status indicando que o comando não pôde ser executado. Alguns VCRs podem desativar apenas combinações de faixas, não faixas individuais; por exemplo, a primeira faixa de áudio e uma faixa de vídeo de um cassete de vídeo. Nesse caso, basta usar setaudio e setvideo para continuar a desativar as outras faixas que compõem a combinação. O driver desativará as faixas quando receber o comando para desativar a última faixa na combinação.
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] |