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 |
|