Compartir a través de


comando MCI_SETAUDIO

El comando MCI_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 mciSendCommand con los parámetros siguientes.

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

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.

lpSetAudio

Puntero a una estructura de MCI_GENERIC_PARMS . (Los dispositivos con conjuntos de comandos extendidos pueden reemplazar esta estructura por una estructura específica del dispositivo).

Valor devuelto

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

Comentarios

Las marcas siguientes se aplican al tipo de dispositivo digitalvideo :

MCI_DGV_SETAUDIO_ALG

El miembro lpstrAlgorithm de la estructura identificada por lpSetAudio contiene una dirección de un búfer que contiene el nombre de un algoritmo de compresión de audio. El algoritmo de compresión lo usan los siguientes comandos MCI_RESERVE o MCI_RECORD . Los algoritmos disponibles dependen del dispositivo. Si el algoritmo no es compatible con el formato de archivo actual, el formato de archivo se cambia al formato predeterminado para el algoritmo.

MCI_DGV_SETAUDIO_CLOCKTIME

El tiempo especificado está en milisegundos y es el tiempo absoluto cuando se usa con MCI_DGV_SETAUDIO_OVER. (Esta vez no está en paso con la reproducción del área de trabajo).

MCI_DGV_SETAUDIO_INPUT

Modifica la marca de bajo, treble o volumen para que afecte a la señal de entrada y modifique lo que se graba. Si es posible, este es el valor predeterminado al supervisar la entrada.

MCI_DGV_SETAUDIO_ITEM

Se especifica una constante de audio en el miembro dwItem de la estructura identificada por lpSetAudio. La constante identifica el valor que se va a establecer. Se definen las siguientes constantes:

MCI_DGV_SETAUDIO_AVGBYTESPERSEC

El número medio de bytes se especifica en el miembro dwValue de la estructura identificada por lpSetAudio. Este valor establece el número medio de bytes por segundo para reproducir o grabar en los formatos PCM (Modulación de código de pulso) y ADPCM (modulación de código de pulso diferencial adaptable). El archivo se guarda en este formato.

MCI_DGV_SETAUDIO_BASS

El nivel de frecuencia baja de audio se especifica como un factor en el miembro dwValue de la estructura identificada por lpSetAudio.

MCI_DGV_SETAUDIO_BITSPERSAMPLE

El número de bits por muestra se especifica en el miembro dwValue de la estructura identificada por lpSetAudio. Este valor establece el número de bits por ejemplo reproducidos o grabados en el formato PCM. El archivo se guarda en este formato.

MCI_DGV_SETAUDIO_BLOCKALIGN

La alineación del bloque de datos se especifica en el miembro dwValue de la estructura identificada por lpSetAudio. Este valor establece la alineación de los bloques de datos en relación con el inicio de los datos de forma de onda de entrada.

MCI_DGV_SETAUDIO_SAMPLESPERSEC

La frecuencia de muestreo se especifica en el miembro dwValue de la estructura identificada por lpSetAudio. Este valor establece la velocidad de muestreo para reproducir y grabar con los algoritmos PCM y ADPCM. El archivo se guarda en este formato.

MCI_DGV_SETAUDIO_SOURCE

Una constante que especifica el origen de la entrada de audio se incluye en el miembro dwValue de la estructura identificada por lpSetAudio. Las siguientes constantes se definen para los orígenes de entrada de audio:

MCI_DGV_SETAUDIO_SOURCE_AVERAGE

Promedio de los canales de audio izquierdo y derecho.

MCI_DGV_SETAUDIO_SOURCE_LEFT

Canal de audio izquierdo.

MCI_DGV_SETAUDIO_SOURCE_RIGHT

Canal de audio derecho.

MCI_DGV_SETAUDIO_SOURCE_STEREO

Estéreo.

MCI_DGV_SETAUDIO_STREAM

Se especifica una secuencia de audio en el miembro dwValue de la estructura identificada por lpSetAudio. El valor entero especifica la secuencia de audio reproducida desde el área de trabajo. Si no se especifica la secuencia, se reproduce la primera secuencia de audio intercalada físicamente.

MCI_DGV_SETAUDIO_TREBLE

El nivel de alta frecuencia de audio se especifica como un factor en el miembro dwValue de la estructura identificada por lpSetAudio.

MCI_DGV_SETAUDIO_VOLUME

El nivel de audio de uno o ambos canales de audio se especifica como un factor en el miembro dwValue de la estructura identificada por lpSetAudio. 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.

MCI_DGV_SETAUDIO_LEFT

Habilita el canal de audio izquierdo cuando se usa con MCI_SET_ON. Deshabilita el canal de audio izquierdo cuando se usa con MCI_SET_OFF. Cuando se usa esta marca con la combinación de MCI_DGV_SETAUDIO_VALUE y MCI_DGV_SETAUDIO_VOLUME, establece el volumen del canal de audio izquierdo. Cuando se usa esta marca con MCI_DGV_SETAUDIO_SOURCE, especifica el canal de audio izquierdo como origen del digitalizador de entrada de audio.

MCI_DGV_SETAUDIO_OVER

Un parámetro de longitud de transición se incluye en el miembro dwOver de la estructura identificada por lpSetAudio. El valor de longitud especifica cuánto tiempo (en unidades del formato de hora actual) debe tardar en realizar un cambio que use un factor. Si no se usa esta marca, los cambios se producen inmediatamente.

MCI_DGV_SETAUDIO_QUALITY

El miembro lpstrQuality de la estructura identificada por lpSetAudio contiene una dirección de un búfer que define la calidad de audio. Una cadena de texto dentro del búfer especifica las características del algoritmo de compresión de audio.

La marca MCI_DGV_SETAUDIO_ALG se puede usar para seleccionar un descriptor de calidad para el algoritmo especificado. Si se omite esta marca, se usa el algoritmo actual.

Los algoritmos y los nombres de descriptor disponibles dependen del dispositivo. Cada dispositivo proporciona documentación para los algoritmos disponibles y una descripción de los nombres de descriptor aplicables. El comando MCI_QUALITY puede definir nombres de descriptor adicionales.

MCI_DGV_SETAUDIO_RECORD

Especifica si la grabación incluye o excluye los datos de audio. Cuando se combina con MCI_SET_ON, se graban datos de audio. Cuando se combina con MCI_SET_OFF, se excluyen los datos de audio. El valor predeterminado incluye datos de audio.

MCI_DGV_SETAUDIO_RIGHT

Habilita el canal de audio correcto cuando se usa con MCI_SET_ON. Deshabilita el canal de audio correcto cuando se usa con MCI_SET_OFF. Cuando se usa esta marca con la combinación de MCI_DGV_SETAUDIO_VALUE y MCI_DGV_SETAUDIO_VOLUME, establece el volumen del canal de audio derecho.

MCI_DGV_SETAUDIO_VALUE

Se especifica un valor en el miembro dwValue de la estructura identificada por lpSetAudio. El significado del valor se especifica mediante la constante definida para la marca MCI_DGV_SETAUDIO_ITEM.

MCI_SET_OFF

Deshabilita el canal de audio especificado.

MCI_SET_ON

Habilita el canal de audio especificado.

MCI_SETAUDIO_OUTPUT

Modifica la marca de bajo, treble o volumen para que modifique solo la señal reproducida y no lo que se graba. Si es posible, este es el valor predeterminado al supervisar la entrada.

En el caso de los dispositivos de vídeo digital, el parámetro lpSetAudio apunta a una estructura de MCI_DGV_SETAUDIO_PARMS .

Las siguientes marcas adicionales se usan con el tipo de dispositivo vcr :

MCI_VCR_SETAUDIO_RECORD

Establece la grabación de audio en activado o desactivado, que se usa junto con una de las marcas siguientes:

MCI_SET_ON

Grabación de audio activada.

MCI_SET_OFF

Grabación de audio desactivada. Es posible que sea necesario desactivar primero la grabación de montaje (con el comando MCI_SET con la marca MCI_VCR_SET_ASSEMBLE_RECORD establecida en desactivado) antes de que se pueda desactivar la grabación de audio.

MCI_TRACK

El miembro dwTrack de la estructura identificada por lpSetAudio especifica qué pista se ve afectada por el comando.

MCI_VCR_SETAUDIO_SOURCE

Establece el origen de audio. Esta marca debe usarse con la marca MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_MONITOR

Establece el monitor de origen de audio. Esta marca debe usarse con la marca MCI_VCR_SETAUDIO_TO.

MCI_VCR_SETAUDIO_TO

El miembro dwTo de la estructura identificada por lpSetAudio contiene una constante que describe el tipo de entrada o entrada supervisada. Debe ser uno de los siguientes:

MCI_VCR_SRC_TYPE_TUNER

El tipo es el tóner.

MCI_VCR_SRC_TYPE_LINE

El tipo es línea.

MCI_VCR_SRC_TYPE_AUX

El tipo es auxiliar.

MCI_VCR_SRC_TYPE_GENERIC

El tipo es genérico.

MCI_VCR_SRC_TYPE_MUTE

El tipo es silenciado. Solo se puede usar con la marca MCI_VCR_SETAUDIO_SOURCE.

MCI_VCR_SRC_TYPE_OUTPUT

El tipo es la salida.

MCI_VCR_SETAUDIO_NUMBER

El miembro dwNumber de la estructura identificada por lpSetAudio contiene la entrada de audio (del tipo especificado en el miembro dwTo) que se va a usar.

En el caso de los dispositivos VCR, el parámetro lpSetAudio apunta a una estructura de MCI_VCR_SETAUDIO_PARMS .

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]
Encabezado
Mmsystem.h (incluya Windows.h)

Consulte también

MCI

Comandos MCI