comando MCI_SETAUDIO

O comando MCI_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 mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETAUDIO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetAudio
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpSetAudio

Ponteiro para uma estrutura MCI_GENERIC_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Os seguintes sinalizadores se aplicam ao tipo de dispositivo digitalvideo :

MCI_DGV_SETAUDIO_ALG

O membro lpstrAlgorithm da estrutura identificada por lpSetAudio contém um endereço de um buffer que contém o nome de um algoritmo de compactação de áudio. O algoritmo de compactação é usado por comandos MCI_RESERVE ou MCI_RECORD subsequentes. Os algoritmos disponíveis dependem do dispositivo. Se o algoritmo for incompatível com o formato de arquivo atual, o formato do arquivo será alterado para o formato padrão do algoritmo.

MCI_DGV_SETAUDIO_CLOCKTIME

A hora especificada está em milissegundos e é a hora absoluta quando usada com MCI_DGV_SETAUDIO_OVER. (Desta vez não está em etapa com a reprodução do workspace.)

MCI_DGV_SETAUDIO_INPUT

Modifica o sinalizador de 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.

MCI_DGV_SETAUDIO_ITEM

Uma constante de áudio é especificada no membro dwItem da estrutura identificada por lpSetAudio. A constante identifica o valor que está sendo definido. As seguintes constantes são definidas:

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

O número médio de bytes é especificado no membro dwValue da estrutura identificada por lpSetAudio. Esse valor define o número médio de bytes por segundo para reprodução ou gravação nos formatos PCM (Pulse Code Modulation) e ADPCM (Adaptive Differential Pulse Code Modulation). O arquivo é salvo nesse formato.

MCI_DGV_SETAUDIO_BASS

O nível de baixa frequência de áudio é especificado como um fator no membro dwValue da estrutura identificada por lpSetAudio.

MCI_DGV_SETAUDIO_BITSPERSAMPLE

O número de bits por amostra é especificado no membro dwValue da estrutura identificada por lpSetAudio. Esse valor define o número de bits por amostra reproduzido ou registrado no formato PCM. O arquivo é salvo nesse formato.

MCI_DGV_SETAUDIO_BLOCKALIGN

O alinhamento do bloco de dados é especificado no membro dwValue da estrutura identificada por lpSetAudio. Esse valor define o alinhamento dos blocos de dados em relação ao início dos dados de forma de onda de entrada.

MCI_DGV_SETAUDIO_SAMPLESPERSEC

A taxa de amostragem é especificada no membro dwValue da estrutura identificada por lpSetAudio. Esse valor define a taxa de amostragem para reprodução e gravação com os algoritmos PCM e ADPCM. O arquivo é salvo nesse formato.

MCI_DGV_SETAUDIO_SOURCE

Uma constante que especifica a origem da entrada de áudio é incluída no membro dwValue da estrutura identificada por lpSetAudio. As seguintes constantes são definidas para as fontes de entrada de áudio:

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

A média dos canais de áudio à esquerda e à direita.

MCI_DGV_SETAUDIO_SOURCE_LEFT

Canal de áudio esquerdo.

MCI_DGV_SETAUDIO_SOURCE_RIGHT

Canal de áudio direito.

MCI_DGV_SETAUDIO_SOURCE_STEREO

Estéreo.

MCI_DGV_SETAUDIO_STREAM

Um fluxo de áudio é especificado no membro dwValue da estrutura identificada por lpSetAudio. O valor inteiro especifica o fluxo de áudio reproduzido do workspace. Se o fluxo não for especificado, o primeiro fluxo de áudio fisicamente intercalado será reproduzido.

MCI_DGV_SETAUDIO_TREBLE

O nível de alta frequência de áudio é especificado como um fator no membro dwValue da estrutura identificada por lpSetAudio.

MCI_DGV_SETAUDIO_VOLUME

O nível de áudio de um ou ambos os canais de áudio é especificado como um fator no membro dwValue da estrutura identificada por lpSetAudio. Se os volumes esquerdo e direito tiverem sido definidos como valores diferentes, a proporção do volume da esquerda para a direita será praticamente inalterada.

MCI_DGV_SETAUDIO_LEFT

Habilita o canal de áudio à esquerda quando usado com MCI_SET_ON. Desabilita o canal de áudio esquerdo quando usado com MCI_SET_OFF. Quando esse sinalizador é usado com a combinação de MCI_DGV_SETAUDIO_VALUE e MCI_DGV_SETAUDIO_VOLUME, ele define o volume do canal de áudio esquerdo. Quando esse sinalizador é usado com MCI_DGV_SETAUDIO_SOURCE, ele especifica o canal de áudio esquerdo como a origem do digitalizador de entrada de áudio.

MCI_DGV_SETAUDIO_OVER

Um parâmetro de comprimento de transição é incluído no membro dwOver da estrutura identificada por lpSetAudio. O valor de comprimento especifica quanto tempo (em unidades do formato de hora atual) deve levar para fazer uma alteração que usa um fator. Se esse sinalizador não for usado, as alterações ocorrerão imediatamente.

MCI_DGV_SETAUDIO_QUALITY

O membro lpstrQuality da estrutura identificada por lpSetAudio contém um endereço de um buffer que define a qualidade do áudio. Uma cadeia de caracteres de texto dentro do buffer especifica as características do algoritmo de compactação de áudio.

O sinalizador MCI_DGV_SETAUDIO_ALG pode ser usado para selecionar um descritor de qualidade para o algoritmo especificado. Se esse sinalizador for omitido, o algoritmo atual será usado.

Os algoritmos e nomes de descritor disponíveis dependem do dispositivo. Cada dispositivo fornece documentação para os algoritmos disponíveis e uma descrição dos nomes de descritor aplicáveis. O comando MCI_QUALITY pode definir nomes de descritores adicionais.

MCI_DGV_SETAUDIO_RECORD

Especifica se a gravação inclui ou exclui dados de áudio. Quando combinados com MCI_SET_ON, os dados de áudio são gravados. Quando combinados com MCI_SET_OFF, os dados de áudio são excluídos. O padrão inclui dados de áudio.

MCI_DGV_SETAUDIO_RIGHT

Habilita o canal de áudio correto quando usado com MCI_SET_ON. Desabilita o canal de áudio correto quando usado com MCI_SET_OFF. Quando esse sinalizador é usado com a combinação de MCI_DGV_SETAUDIO_VALUE e MCI_DGV_SETAUDIO_VOLUME, ele define o volume do canal de áudio correto.

MCI_DGV_SETAUDIO_VALUE

Um valor é especificado no membro dwValue da estrutura identificada por lpSetAudio. O significado do valor é especificado pela constante definida para o sinalizador MCI_DGV_SETAUDIO_ITEM.

MCI_SET_OFF

Desabilita o canal de áudio especificado.

MCI_SET_ON

Habilita o canal de áudio especificado.

MCI_SETAUDIO_OUTPUT

Modifica o sinalizador de 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 a entrada.

Para dispositivos de vídeo digital, o parâmetro lpSetAudio aponta para uma estrutura MCI_DGV_SETAUDIO_PARMS .

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo vcr :

MCI_VCR_SETAUDIO_RECORD

Define a gravação de áudio como ativada ou desativada, que é usada em conjunto com um dos seguintes sinalizadores:

MCI_SET_ON

Gravação de áudio ativada.

MCI_SET_OFF

Gravação de áudio desativada. Talvez seja necessário primeiro desativar a gravação de montagem (usando o comando MCI_SET com o sinalizador MCI_VCR_SET_ASSEMBLE_RECORD definido como desativado) antes que a gravação de áudio possa ser desativada.

MCI_TRACK

O membro dwTrack da estrutura identificada por lpSetAudio especifica qual faixa é afetada pelo comando.

MCI_VCR_SETAUDIO_SOURCE

Define a fonte de áudio. Esse sinalizador deve ser usado com o sinalizador MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_MONITOR

Define o monitor de origem de áudio. Esse sinalizador deve ser usado com o sinalizador MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_TO

O membro dwTo da estrutura identificada por lpSetAudio contém uma constante que descreve o tipo de entrada ou entrada monitorada. Deve ser um dos seguintes:

MCI_VCR_SRC_TYPE_TUNER

O tipo é sintonizador.

MCI_VCR_SRC_TYPE_LINE

O tipo é line.

MCI_VCR_SRC_TYPE_AUX

O tipo é auxiliar.

MCI_VCR_SRC_TYPE_GENERIC

O tipo é genérico.

MCI_VCR_SRC_TYPE_MUTE

O tipo é mudo. Isso só pode ser usado com o sinalizador MCI_VCR_SETAUDIO_SOURCE.

MCI_VCR_SRC_TYPE_OUTPUT

O tipo é saída.

MCI_VCR_SETAUDIO_NUMBER

O membro dwNumber da estrutura identificada por lpSetAudio contém a entrada de áudio (do tipo especificado no membro dwTo) a ser usado.

Para dispositivos VCR, o parâmetro lpSetAudio aponta para uma estrutura MCI_VCR_SETAUDIO_PARMS .

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]
Cabeçalho	Mmsystem.h (incluir Windows.h)

Confira também

MCI

Comandos MCI