Comando setaudio

El comando setaudio establece los valores asociados a la reproducción y captura de audio. Los dispositivos de vídeo digital y VCR 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("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
); 

Parámetros

lpszDeviceID

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

lpszAudio

Marca para la reproducción y captura de audio. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando setaudio y las marcas usadas por cada tipo.

Valor	Significado	Significado
digitalvideo	alineación del algoritmo de algoritmocon bajo enteroa bits de factorpersamplepara bit_count bytespersec a la entrada de tiempo de reloj enteroizquierda izquierda en el volumen izquierdo para factorizaren la salida	over durationquality descriptorrecord off record on right off off right on right to factorsamplespersec to integersource stream tonumbertreble to factorvolume to factor
Vcr	off on monitor to typenumber numberrecord off record off record track track_number off off	record on record track track_number on source to typenumber tracktrack track_number off track track_number on track on

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

Valor	Significado
algoritmo de algoritmo	Selecciona un algoritmo de compresión de audio específico para que lo use un comando de reserva o registro posterior. Los algoritmos admitidos son específicos del dispositivo. MCI define los valores "g711", "g721", "g722", "g728", "pcm", "cdxa", "adpcm" y "adpcm4e" para el algoritmo. Si un dispositivo admite los nombres de algoritmo "pcm", "cdxa" y "adpcm4e", se adhieren a las definiciones estándar. Sony Corporation ha definido el algoritmo "cdxa". Intel Corporation ha definido el algoritmo "adpcm4e". Los valores "g711", "g721", "g722" y "g728" representan algoritmos de audio recomendados por el Comité Consultivo Internacional de Telégrafos y Telefónicos (CCITT). Si el algoritmo especificado entra en conflicto con el formato de archivo actual, el formato de archivo se cambia al formato predeterminado para el algoritmo.
alineación con enteros	Establece la alineación de los bloques de datos en relación con el inicio de los datos de audio de forma de onda de entrada.
bass to factor	Establece el nivel de frecuencia baja de audio.
bitspersample para bit_count	Establece el número de bits por muestra registrado. El archivo se guarda en este formato. Esta marca solo se aplica a los dispositivos que admiten el algoritmo "pcm".
bytespersec en entero	Establece el número medio de bytes por segundo para la grabación en los algoritmos "pcm" y "adpcm". El archivo se guarda en este formato.
clocktime	Indica la hora especificada en la marca "over" en milisegundos. Esta vez es absoluta y no en paso con la reproducción del área de trabajo.
input	Modifica la marca "bass", "treble" o "volume" para que afecte a la señal de entrada y modifique lo que se registra. Si es posible, este es el valor predeterminado al supervisar la entrada.
izquierda a la izquierda en	Habilita o deshabilita la salida de audio en el canal izquierdo. El origen de la presentación de audio puede ser la entrada externa o el área de trabajo. El valor predeterminado es "left on". Si solo hay un canal, ese canal está activado o desactivado.
volumen izquierdo al factor	Establece el volumen de audio del canal de audio izquierdo. Si solo hay un canal, establece su volumen.
supervisión al número de númerode tipo	Controla qué entrada de origen se pasará a la salida de VCR sin cambiar la selección de entrada de origen de grabación. El tipo puede ser "output" o uno de los orígenes de entrada válidos. Si no se especifica number , se elegirá la primera entrada de ese tipo.
desactivado	Habilita o deshabilita el audio. El origen de la presentación de audio puede ser la entrada externa o el área de trabajo. Este comando afecta a los canales de audio izquierdo y derecho simultáneamente. El valor predeterminado es setaudio "on".
output	Modifica la marca "bass", "treble" o "volume" para que modifique solo la señal reproducida y no lo que se graba. Si es posible, este es el valor predeterminado al supervisar un archivo.
sobre duración	Especifica cuánto tiempo debe tardar en realizar un cambio que use una variable de factor . Las unidades de duración están en el formato de hora actual. Los cambios se producen en el paso con la reproducción del área de trabajo. Cuando se suspende la reproducción, el cambio también se suspende hasta que la reproducción continúa. Si no se especifica "over" o no se admite, el cambio se produce inmediatamente.
descriptor de calidad	Especifica las características de la compresión de audio realizada cuando el audio se graba en un archivo. Todos los dispositivos admiten los tres descriptores "bajo", "medio" y "alto". El valor predeterminado es específico del dispositivo. Si no se especifica la marca "algorithm", el ajuste de "calidad" se aplica al algoritmo actual. El comando de calidad se puede usar para definir nombres de descriptor adicionales.
grabación desactivada	Borra la selección de origen de audio para que no se grabe ningún audio con el siguiente comando de grabación .
registro en	Habilita la grabación de datos de audio. El valor predeterminado es grabar datos de audio.
record track track_number off	Borra la selección de origen de audio para que no se grabe ningún audio con el siguiente comando de grabación . "Pista" permite la selección de pista independiente. Pista 2 corresponde a la pista PCM en Hi8. Si no se especifica "track", se supone un valor predeterminado de 1.
registro de track_number de pista en	Selecciona el origen de audio que se va a grabar con el siguiente comando de registro . "Pista" permite la selección de pista independiente. Pista 2 corresponde a la pista PCM en Hi8. Si no se especifica "track", se supone un valor predeterminado de 1.
justo a la derecha en	Habilita o deshabilita la salida de audio en el canal derecho. El origen de la presentación de audio puede ser la entrada externa o el área de trabajo. El valor predeterminado es "right on". Si solo hay un canal, esta marca no tiene ningún efecto.
volumen derecho al factor	Establece el volumen de audio en el canal de audio correcto. Si solo hay un canal, no tiene ningún efecto.
samplespersec to integer	Establece la frecuencia de muestreo para la grabación con los algoritmos "pcm" y "adpcm". El archivo se guarda en este formato.
source to sourcename	Especifica el origen del digitalizador de entrada de audio. Las constantes definidas para sourcename incluyen: "left", "right", "average" y "stereo". Las tres primeras especifican la grabación monofónica usando solo la entrada izquierda, solo la entrada derecha y el promedio de las dos entradas.
origen al número de número detipo	Selecciona el origen de audio que se va a grabar en la cinta. El tipo debe ser "tuner", "line", "svideo", "aux", "generic" o "mute".
secuencia al número	Especifica la secuencia de audio reproducida desde el área de trabajo. Si no se especifica la secuencia y el formato de archivo no define un valor predeterminado, la secuencia de audio intercalada que se reproduce físicamente primero.
track_number de seguimiento desactivado	Deshabilita una pista individual.
seguimiento de track_number en	Habilita una pista individual.
treble a factor	Establece el nivel de alta frecuencia de audio.
volumen a factor	Establece el volumen de audio promedio para ambos canales de audio. Si los volúmenes izquierdo y derecho se han establecido en valores diferentes, la proporción del volumen de izquierda a derecha es aproximadamente sin cambios.

lpszFlags

Puede ser "wait", "notify", "test" o una combinación de estos. Para obtener más información sobre estas marcas, vea Las marcas de espera, notificación y prueba.

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario.

Comentarios

En el caso de los dispositivos VCR, el uso de setaudio con una marca que desactive una pista individual ("track track_number off") podría hacer que la aplicación reciba un mensaje de estado que indica que no se pudo realizar el comando. Algunos VCR pueden desactivar solo combinaciones de pistas, no pistas individuales; por ejemplo, la primera pista de audio y una pista de vídeo de un casesette de vídeo. En este caso, simplemente use setaudio y setvideo para continuar desactivando las otras pistas que componen la combinación. El controlador apagará las pistas cuando reciba el comando para desactivar la última pista de la combinación.

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

record

reserva

setvideo