Compartir a través de


Comando set

Nota

La comunicación sin sesgos de Microsoft admite un entorno diverso e inclusión. Dentro de este documento, hay referencias a la palabra 'slave'. La Guía de estilo de Microsoft para Bias-Free Comunicaciones lo reconoce como una palabra excluyente. Esta redacción se usa tal y como se usa actualmente en los comandos. Por coherencia, este documento contiene esta palabra. Cuando esta palabra se modifique en los comandos, corregiremos este documento para que esté en alineación.

El comando set establece la configuración de control para el dispositivo. Los dispositivos cd audio, digital-video, midi sequencer, VCR, videodisc, video-overlay y waveform-audio 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("set %s %s %s"),
  lpszDeviceID,
  lpszSetting,
  lpszFlags
);
      

Parámetros

lpszDeviceID

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

lpszSetting

Marca para establecer la configuración del control. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando set y las marcas usadas por cada tipo.

Tipo de dispositivo Marcas de comando
cdaudio
  • audio todo desactivado
  • audio todo activado
  • audio dejado
  • audio a la izquierda
  • audio a la derecha
  • audio a la derecha
  • puerta cerrada
  • puerta abierta
  • formato de hora milisegundos
  • formato de hora msf
  • formato de hora tmsf
digitalvideo
  • audio todo desactivado
  • audio todo activado
  • audio dejado
  • audio a la izquierda
  • audio a la derecha
  • audio a la derecha
  • puerta cerrada
  • puerta abierta
  • formato de formato de archivo
  • buscar exactamente en
  • buscar exactamente desactivado
  • factor de velocidad
  • formato de archivo todavía
  • períodos de formato de hora
  • formato de hora milisegundos
  • vídeo desactivado
  • vídeo en
overlay
  • audio todo desactivado
  • audio todo activado
  • audio dejado
  • audio a la izquierda
  • audio a la derecha
  • audio a la derecha
  • puerta cerrada
  • puerta abierta
  • vídeo desactivado
  • vídeo en
sequencer
  • audio todo desactivado
  • audio todo activado
  • audio dejado
  • audio a la izquierda
  • audio a la derecha
  • audio a la derecha
  • puerta cerrada
  • puerta abierta
  • master MIDI
  • master none
  • master SMPTE
  • hora de desplazamiento
  • asignador de puertos
  • port none
  • puerto port_number
  • archivo subordinado
  • MIDI esclavo
  • slave none
  • slave SMPTE
  • tempo tempo_value
  • formato de hora milisegundos
  • formato de hora SMPTE fps
  • formato de hora SMPTE 30 drop
  • puntero de canciones de formato de hora
Vcr
  • ensamblador registro en
  • ensamblador registro desactivado
  • audio todo desactivado
  • audio todo activado
  • audio dejado
  • audio a la izquierda
  • audio a la derecha
  • audio a la derecha
  • hora del reloj
  • formato de contador
  • valor de contador
  • puerta cerrada
  • puerta abierta
  • contador de índice
  • fecha de índice
  • tiempo de índice
  • tiempo de índice
  • duración de codelength
  • tiempo de espera de pausa
  • duración de la inscripción posterior:
  • duration
  • encendido
  • apagar
  • duración de inscripción previa
  • formato de registro SP
  • formato de registro LP
  • formato de registro EP
  • factor de velocidad
  • períodos de formato de hora
  • formato de hora hms
  • formato de hora milisegundos
  • formato de hora msf
  • formato de hora SMPTE fps
  • time format SMPTE 30 drop
  • formato de hora tmsf
  • Contador del modo de tiempo
  • detección del modo de tiempo
  • time mode timecode
  • seguimiento más
  • seguimiento menos
  • restablecimiento de seguimiento
Videodisco
  • audio todo desactivado
  • audio todo activado
  • audio quedó desactivado
  • audio a la izquierda
  • audio desactivado
  • audio a la derecha
  • puerta cerrada
  • puerta abierta
  • períodos de formato de hora
  • formato de hora hms
  • formato de hora milisegundos
  • seguimiento de formato de hora
  • vídeo desactivado
  • vídeo en
waveaudio
  • entero de alineación
  • cualquier entrada
  • cualquier salida
  • audio todo desactivado
  • audio todo activado
  • audio quedó desactivado
  • audio a la izquierda
  • audio desactivado
  • audio a la derecha
  • bitspersample bit_count
  • bytespersec byte_rate
  • canales channel_count
  • puerta cerrada
  • puerta abierta
  • format tag pcm
  • etiqueta de formato
  • entero de entrada
  • entero de salida
  • samplespersec entero
  • bytes de formato de hora
  • formato de hora milisegundos
  • ejemplos de formato de hora

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

Valor Significado
entero de alineación Establece la alineación de los bloques de datos en relación con el inicio de los datos pasados al dispositivo de audio de forma de onda. El archivo se guarda en este formato.
cualquier entrada Use cualquier entrada que admita el formato actual al grabar. Esta es la configuración predeterminada.
cualquier salida Use cualquier salida que admita el formato actual al reproducir. Este es el valor predeterminado.
ensamblador registro en
ensamblador registro desactivado
En el modo de montaje, todas las pistas se registran según lo definido por el dispositivo. La mayoría de los VCR están en modo ensamblado de forma predeterminada.
audio todo desactivado
audio todo activado
Deshabilita o habilita la salida de audio. Los dispositivos de superposición de vídeo, el secuenciador MCISEQ y el dispositivo MCIWAVE waveform-audio no admiten esta marca.
audio quedó desactivado
audio a la izquierda
audio desactivado
audio a la derecha
Deshabilita o habilita la salida en el canal de audio izquierdo o derecho. Los dispositivos de superposición de vídeo, el secuenciador MCISEQ y el dispositivo MCIWAVE waveform-audio no admiten esta marca.
bitspersample bit_count Establece el número de bits por muestra de PCM (Modulación de código de pulso) reproducida o grabada. El archivo se guarda en este formato.
bytespersec byte_rate Establece el número medio de bytes por segundo reproducidos o grabados. El archivo se guarda en este formato.
canales channel_count Establece los canales para reproducir y grabar. El archivo se guarda en este formato.
hora del reloj Establece la hora del reloj externo en la hora. El formato se especifica como un entero largo sin signo.
formato de contador Establezca el formato de hora para el contador, tal y como devuelve el estado "counter". Para obtener información sobre los tipos aplicables, vea el comando set "time format".
valor de contador Establece el contador VCR en el valor especificado. El valor debe especificarse en el formato de contador actual. Para obtener más información, vea el comando set "counter format".
puerta cerrada Retira la bandeja y cierra la puerta, si es posible. En el caso de los VCR, carga automáticamente la cinta.
puerta abierta Abre la puerta y expulsa la bandeja o cinta, si es posible.
formato de archivo Especifica un formato de archivo que se usa para los comandos de guardado o captura . Si se omite, esto podría tener como valor predeterminado un formato definido por el controlador de dispositivo. Si el formato de archivo especificado entra en conflicto con el algoritmo y la calidad seleccionados actualmente, se cambian a los valores predeterminados para el formato de archivo. Se definen los siguientes formatos de archivo:
  • avi: especifica el formato AVI.
  • avss: especifica el formato avSS.
  • dib: especifica el formato DIB.
  • jfif: especifica el formato JFIF.
  • jpeg: especifica el formato JPEG.
  • mpeg: especifica el formato MPEG.
  • rdib: especifica el formato DIB RLE.
  • rjpeg: especifica el formato RJPEG.
format tag pcm Establece el tipo de formato en PCM para reproducir y grabar. El archivo se guarda en este formato.
etiqueta de formato Establece el tipo de formato para reproducir y grabar. El archivo se guarda en este formato.
código de tiempo de índice
contador de índice
fecha de índice
tiempo de índice
Establece la pantalla de visualización actual en el VCR.
entero de entrada Establece el canal de audio utilizado como entrada.
duración de longitud Establece la longitud especificada por el usuario de la cinta en VCR. El comando de estado "length" devuelve esta longitud y se proporciona para la compatibilidad con las aplicaciones que requieren que este comando devuelva una longitud válida.
master midi Establece el secuenciador MIDI como origen de sincronización. Los datos de sincronización se envían en formato MIDI. El secuenciador MCISEQ no admite esta marca.
master none Impide que el secuenciador MIDI envíe datos de sincronización. El secuenciador MCISEQ no admite esta marca.
master smpte Establece el secuenciador MIDI como origen de sincronización. Los datos de sincronización se envían en formato SMPTE (Society of Motion Picture and Television Engineers). El secuenciador MCISEQ no admite esta marca.
tiempo de desplazamiento Establece el tiempo de desplazamiento de SMPTE. El desplazamiento es la hora inicial de una secuencia basada en SMPTE. El tiempo se expresa como hh: mm: ss: ff, donde hh es horas, mm es minutos, ss es segundos y ff es marcos.
entero de salida Establece el canal de audio usado como salida.
tiempo de espera de pausa Establece la duración máxima, en milisegundos, de un comando de pausa . Un valor de tiempo de espera de cero indica que no se producirá ningún tiempo de espera.
duración de la inscripción posterior Establece la longitud, en el formato de hora actual, necesario para detener el transporte de VCR cuando se emite un comando stop o pause .
asignador de puertos Establece el asignador MIDI como puerto que recibe los mensajes MIDI. Este comando produce un error si otra aplicación usa el asignador MIDI o un puerto que necesita.
port none Deshabilita el envío de mensajes MIDI. Este comando también cierra un puerto MIDI.
port_number de puerto Establece el puerto MIDI que recibe los mensajes MIDI. Este comando produce un error si otro aplicación está usando el puerto que está intentando abrir.
encendido
apagar
Establece la alimentación del dispositivo en encendido o apagado.
duración de inscripción previa Establece la longitud, en el formato de hora actual, necesaria para estabilizar la salida de VCR.
formato de registro SP
formato de registro LP
formato de registro EP
Establece el modo de grabación del VCR en SP para la reproducción estándar, EP para la reproducción extendida o LP para una reproducción larga. Estos valores no están diseñados para ser específicos de VHS. Se asignan a tres modos adecuados con otros formatos de cinta. Por ejemplo, SP se asigna a la grabación más rápida y de mayor calidad.
samplespersec entero Establece la velocidad de muestreo para reproducir y grabar. El archivo se guarda en este formato.
buscar exactamente en
buscar exactamente desactivado
Selecciona uno de los dos modos de búsqueda. Con "seek exactamente activado", seek siempre se moverá al marco especificado. Con "seek exactamente off", seek se moverá al fotograma clave más cercano antes del marco especificado.
archivo subordinado Establece el secuenciador MIDI para usar los datos de archivo como origen de sincronización. Esta es la configuración predeterminada.
esclava midi Establece el secuenciador MIDI para usar los datos MIDI entrantes para el origen de sincronización. El secuenciador reconoce los datos de sincronización con el formato MIDI. El secuenciador MCISEQ no admite esta marca.
slave none Establece el secuenciador MIDI para omitir la sincronización
smpte esclavo Establece el secuenciador MIDI para usar los datos MIDI entrantes para el origen de sincronización. El secuenciador reconoce los datos de sincronización con el formato SMPTE. El secuenciador MCISEQ no admite esta marca.
factor de velocidad Establece la velocidad relativa de la reproducción de vídeo y audio desde el área de trabajo. Factor es la relación entre la velocidad nominal de fotogramas y la velocidad de fotograma deseada, donde la velocidad nominal de fotogramas se designa como 1000. (Una velocidad de 500 es media velocidad normal, 2000 es dos veces la velocidad normal, y así sucesivamente). Al establecer la velocidad en cero, se reproduce el vídeo lo más rápido posible sin soltar fotogramas y sin audio.
formato de archivo todavía Especifica el formato de archivo usado para los comandos de captura.
tempo tempo_value Establece el tempo de la secuencia según el formato de hora actual. En el caso de un archivo basado en PPQN, el tempo_value se interpreta como ritmos por minuto. Para un archivo basado en SMPTE, el tempo_value se interpreta como fotogramas por segundo.
bytes de formato de hora En un formato de archivo PCM, establece el formato de hora en bytes. Toda la información de posición se especifica como bytes después de este comando.
períodos de formato de hora Establece el formato de hora en fotogramas. Todos los comandos que usan valores de posición asumen fotogramas. Cuando se abre el dispositivo, los marcos son el modo predeterminado. Compatible con videodiscs mediante el formato CAV.
formato de hora hms Establece el formato de tiempo en horas, minutos y segundos. Todos los comandos que usan valores de posición asumen HMS. HMS es el formato predeterminado para videodiscs CLV. Especifique un valor HMS como hh:mm:ss, donde hh es horas, mm es minutos y ss es segundos. Puede omitir un campo si es así y todos los campos siguientes son cero. Por ejemplo, 3, 3:0 y 3:0:0 son todas formas válidas de expresar 3 horas.
formato de hora milisegundos Establece el formato de hora en milisegundos. Todos los comandos que usan valores de posición asumen milisegundos. Puede abreviar milisegundos como "ms". En el caso de los dispositivos secuenciador, el archivo de secuencia establece el formato predeterminado en PPQN o SMPTE. Los dispositivos de superposición de vídeo no admiten esta marca.
formato de hora msf Establece el formato de tiempo en minutos, segundos y fotogramas. Todos los comandos que usan valores de posición asumen MSF (el formato predeterminado para el audio de CD). Especifique un valor msf como mm:ss:ff, donde mm es minutos, ss es segundos y ff es fotogramas. Puede omitir un campo si es así y todos los campos siguientes son cero. Por ejemplo, 3, 3:0 y 3:0:0 son formas válidas de expresar 3 minutos.
Los campos MSF tienen los siguientes valores máximos:
  • Minutos 99
  • Segundos 59
  • Marcos 74
ejemplos de formato de hora Establece el formato de hora en ejemplos. Toda la información de posición se especifica como ejemplos después de este comando.
formato de hora smpte 24
formato de hora smpte 25
formato de hora smpte 30
Establece el formato de hora en una velocidad de fotogramas SMPTE. Para los VCR, establece el formato de hora en hh:mm:ss:ff, donde los valores legales son 00:00:00:00 a 23:59:59:xx, y xx es uno menor que los fotogramas por segundo, según se especifica en el número 24, 25 o 30, tal como se especifica en la marca. En la entrada, dos puntos (:) son necesarios para separar los componentes. Se pueden omitir las unidades menos significativas si son 00; por ejemplo, 02:00 es igual que 02:00:00:00. Todos los comandos que usan valores de posición asumen el formato SMPTE.
El archivo de secuencia establece el formato predeterminado en PPQN o SMPTE.
time format smpte 30 drop Establece el formato de tiempo en la velocidad de fotogramas de caída de SMPTE 30. Para los VCR, igual que SMPTE 30, salvo que determinadas posiciones de código de tiempo se quitan del formato para que las posiciones de código de tiempo grabadas para cada fotograma (en la velocidad de fotogramas NTSC de 29,97 fps) se correspondan con tiempo real (en 30 fps). Las posiciones de código de tiempo que se quitan son las siguientes: dos cada minuto, en el minuto, para los nueve primeros de cada diez minutos de contenido grabado. Por ejemplo, a las 01:04:59:29, la siguiente posición de código de tiempo sería 01:05:00:02, no 01:05:00:00. Todos los comandos que usan valores de posición asumen el formato SMPTE.
El archivo de secuencia establece el formato predeterminado en PPQN o SMPTE.
puntero de canciones de formato de hora Establece el formato de tiempo en el puntero de la canción (dieciséis notas). Todos los comandos que usan valores de posición asumen unidades de puntero de canción. Esta marca solo es válida para una secuencia de tipo de división PPQN.
formato de hora tmsf Establece el formato de tiempo en las pistas, minutos, segundos y fotogramas. Todos los comandos que usan valores de posición asumen TMSF. Especifique un valor TMSF como tt:mm:ss:ff, donde tt es pistas, mm es minutos, ss es segundos y ff es fotogramas. Puede omitir un campo si es así y todos los campos siguientes son cero. Por ejemplo, 3, 3:0, 3:0:0 y 3:0:0:0 son todas formas válidas de expresar la pista 3.
Los campos TMSF tienen los siguientes valores máximos:
  • Pistas 99
  • Minutos 90
  • Segundos 59
  • Marcos 74
seguimiento de formato de hora Establece el formato de posición en las pistas. Todos los comandos que usan valores de posición asumen las pistas.
Contador del modo de tiempo Establece el modo de información de posición para usar los contadores de VCR.
detección del modo de tiempo Establece el modo de información de posición en función de la detección de información de código de tiempo en la cinta. Si se detecta información de código de tiempo, el tipo de hora se establece en "timecode"; de lo contrario, el tipo de hora se establece en "counter". "Detectar" es un modo especial. Cada vez que se abre el controlador, se inserta una cinta nueva o se emite el comando "modo de tiempo", el controlador comprueba el modo de hora actual disponible en la cinta y establece "tipo de tiempo" en "timecode" o "counter". Una vez establecido el "tipo de hora", el controlador no lo cambia hasta que se produce una de las condiciones anteriores de nuevo.
time mode timecode Establece el modo de información de posición para usar la información de "código de tiempo" en la cinta.
seguimiento más
seguimiento menos
restablecimiento de seguimiento
Ajusta la velocidad del transporte de videotape en incrementos finos. Use las marcas de "seguimiento" cuando se obtiene una imagen ruidosa de un VCR. "Seguimiento más" aumenta la velocidad de transporte. "Seguimiento menos" disminuye la velocidad de transporte. "Restablecimiento de seguimiento" devuelve el ajuste de seguimiento a cero.
vídeo desactivado Deshabilita la salida de vídeo.
vídeo en Habilita la salida de vídeo.

lpszFlags

Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital y VCR, también se puede especificar "prueba". 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.

Observaciones

Se definen varias propiedades de datos de audio de forma de onda cuando se crea el archivo para almacenar los datos. Estas propiedades describen cómo se estructuran los datos dentro del archivo y no se pueden cambiar una vez que se inicia la grabación. En la lista siguiente se identifican estas propiedades:

  • alineación
  • bitspersample
  • bytespersec
  • canales nueva
  • etiqueta format
  • samplespersec

Ejemplos

El siguiente comando establece el formato de hora en milisegundos y establece el formato de audio de forma de onda en 8 bits, mono, 11 kHz.

set mysound time format ms bitspersample 8 channels 1 samplespersec 11025

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]

Vea también

MCI

Cadenas de comandos de MCI

capturar

pause

guardar

stop