Compartir a través de


comando status

Nota

Comunicación sin sesgos Microsoft admite un entorno diverso e inclusión. En este documento, hay referencias a la palabra "esclavo". La Guía de estilo de Microsoft para Bias-Free Communications lo reconoce como una palabra excluyente. Esta redacción se usa ya que actualmente es el uso de palabras dentro de los comandos. Para la 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 status solicita información de estado desde un dispositivo. Todos los dispositivos 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("status %s %s %s"),
  lpszDeviceID,
  lpszRequest,
  lpszFlags
);
      

Parámetros

lpszDeviceID

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

lpszRequest

Marca para solicitar información de estado. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando status y las marcas usadas por cada tipo.

Tipo de dispositivo Marcas de solicitud
cdaudio
  • número de pista de tipo cdaudio
  • pista actual
  • length
  • length track number
  • media present
  • mode
  • número de pistas
  • position
  • número de pista de posición
  • ready
  • posición inicial
  • formato de hora
digitalvideo
  • audio
  • alineación de audio
  • bits de audiopersample
  • saltos de audio
  • bytes de audiopersec
  • entrada de audio
  • grabación de audio
  • origen de audio
  • Ejemplos de audiopersec
  • secuencia de audio
  • Bajo
  • bitsperpel
  • luminosidad
  • color
  • contraste
  • pista actual
  • unidad de espacio en disco
  • finalización de archivos
  • formato del archivo
  • modo de archivo
  • forward
  • fotogramas omitidos
  • gamma
  • input
  • volumen izquierdo
  • length
  • length track number
  • media present
  • mode
  • monitor
  • monitor (método)
  • Nominal
  • velocidad nominal de fotogramas
  • velocidad nominal de fotogramas de registro
  • número de pistas
  • output
  • identificador de paleta
  • modo de pausa
  • velocidad de reproducción
  • position
  • número de pista de posición
  • ready
  • velocidad de fotogramas de registro
  • marco de referencia
  • tamaño reservado
  • volumen derecho
  • buscar exactamente
  • Nitidez
  • Smpte
  • velocidad
  • posición inicial
  • formato de archivo todavía
  • formato de hora
  • Tinte
  • Agudos
  • Inconversos
  • video
  • índice de clave de vídeo
  • color de la clave de vídeo
  • grabación de vídeo
  • origen de vídeo
  • número de origen de vídeo
  • secuencia de vídeo
  • volumen
  • identificador de ventana
  • ventana visible
  • ventana minimizada
  • ventana maximizada
overlay
  • media present
  • mode
  • número de pistas
  • ready
  • ajustar
  • identificador de ventana
sequencer
  • pista actual
  • tipo de división
  • length
  • length track number master
  • media present
  • mode
  • número de pistas
  • offset
  • port
  • position
  • número de pista de posición
  • ready
  • Esclavo
  • posición inicial
  • Tempo
  • formato de hora
Vcr
  • ensamblador registro
  • Monitor de audio
  • número de monitor de audio
  • grabación de audio
  • número de pista de grabación de audio
  • origen de audio
  • número de origen de audio
  • canal
  • número de tuner de canal
  • clock
  • id. de reloj
  • counter
  • formato de contador
  • resolución de contadores
  • pista actual
  • velocidad de fotogramas
  • índice
  • índice en
  • length
  • length track number
  • media present
  • tipo de medio
  • mode
  • número de pistas de audio
  • número de pistas
  • número de pistas de vídeo
  • tiempo de espera de pausa
  • formato de reproducción
  • position
  • position start
  • número de pista de posición
  • duración de la inscripción posterior
  • encendido
  • duración de inscripción previa
  • ready
  • formato de registro
  • velocidad
  • formato de hora
  • modo de hora
  • tipo de hora
  • código de tiempo presente
  • registro de código de tiempo
  • tipo de código de tiempo
  • número de tuner
  • monitor de vídeo
  • número de monitor de vídeo
  • grabación de vídeo
  • número de pista de grabación de vídeo
  • origen de vídeo
  • número de origen de vídeo
  • escritura protegida
Videodisco
  • pista actual
  • tamaño del disco
  • forward
  • length
  • length track number
  • media present
  • tipo de medio
  • mode
  • número de pistas
  • position
  • número de pista de posición
  • ready
  • Lado
  • velocidad
  • posición inicial
  • formato de hora
waveaudio
  • alineación
  • bitspersample
  • bytespersec
  • canales nueva
  • pista actual
  • etiqueta de formato
  • input
  • length
  • length track number (número de pista de longitud)
  • Nivel
  • medios presentes
  • mode
  • número de pistas
  • output
  • position
  • número de pista de posición
  • ready
  • samplespersec
  • posición inicial
  • formato de hora

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

Value Significado
alineación Devuelve la alineación de bloques de datos, en bytes.
ensamblador registro Devuelve TRUE si el dispositivo está establecido en grabación en modo ensamblado.
audio Devuelve "on" o "off" según el comando setaudio "on" o "off" más reciente. Devuelve "on" si uno o ambos altavoces están habilitados y "off" en caso contrario.
alineación de audio Devuelve la alineación de los bloques de datos con respecto al inicio de los datos de audio de forma de onda de entrada.
bits de audiopersample Devuelve el número de bits por muestra que el dispositivo usa para la grabación. Esta marca solo se aplica a los dispositivos que admiten el algoritmo "pcm".
saltos de audio Devuelve el número de veces que se rompió la parte de audio de la última secuencia AVI. El sistema cuenta una interrupción de audio cada vez que intenta escribir datos de audio en el controlador del dispositivo y detecta que el controlador ya ha reproducido todos los datos disponibles. Este indicador solo lo reconoce el controlador mciavi digital-video. Está pensado solo para la evaluación del rendimiento; el valor devuelto es difícil de interpretar.
bytes de audiopersec Devuelve el número medio de bytes por segundo que se usa para la grabación.
entrada de audio Devuelve el nivel de audio instantáneo aproximado de la señal de audio de entrada analógica. Un valor mayor que 1000 implica distorsión de recorte. Algunos dispositivos solo pueden devolver este valor al grabar audio. El valor no tiene ningún comando set o setaudio asociado.
monitor de audio Devuelve "output" o uno de los tipos de entrada de origen válidos. Para obtener más información, vea el comando setaudio "monitor".
número de monitor de audio Devuelve el número de vídeo supervisado del tipo especificado por el estado "monitor de audio". Para obtener más información, vea el comando setaudio .
grabación de audio Devuelve "on" o "off", que refleja el estado establecido por setaudio "record".
número de pista de grabación de audio Devuelve TRUE si el VCR está establecido en grabar audio. Si no se da ningún número de pista, se asume el valor predeterminado de 1.
ejemplos de audiopersec Devuelve el número de muestras por segundo grabadas.
origen de audio Devuelve el origen del digitalizador de audio actual: "left", "right", "average" o "stereo".
número de origen de audio Devuelve el número de origen de audio del tipo devuelto por el estado "origen de audio". Para obtener más información, vea el comando setaudio .
secuencia de audio Devuelve el número de secuencia de audio actual.
Bajo Devuelve el nivel de bajo de audio actual.
bitsperpel Devuelve el número de bits por píxel para guardar datos capturados o registrados.
bitspersample Devuelve los bits por ejemplo.
luminosidad Devuelve el nivel de brillo de vídeo actual.
bytespersec Devuelve el número medio de bytes por segundo reproducidos o grabados.
número de pista de tipo cdaudio Devuelve el tipo del número de pista especificado. Puede ser "audio" o "otro".
canal Devuelve el valor entero del canal establecido en el tóner.
número de tóner de canal Si se da el número de "tuner", se devolverá el canal seleccionado actualmente en el número de tuner lógico. Tenga en cuenta que puede haber varios tuners lógicos.
canales nueva Devuelve el número de canales establecidos (1 para mono, 2 para estéreo).
clock Devuelve la hora externa. El tiempo debe ser un entero largo sin signo que expresa incrementos totales. Para obtener más información, consulte el comando de funcionalidad "velocidad de incremento de reloj".
id. de reloj Devuelve un entero único que identifica el reloj.
color Devuelve el nivel de color actual.
contraste Devuelve el nivel de contraste actual.
counter Devuelve la posición del contador, en el formato de contador actual.
formato de contador Devuelve el formato de contador actual. Para obtener más información, vea el comando set "counter format".
resolución de contadores Devuelve "frames" o "seconds", que indica la resolución del contador. Esto no es lo mismo que la precisión.
pista actual Devuelve la pista actual. El secuenciador MCISEQ devuelve 1.
tamaño del disco Devuelve 8 o 12, lo que indica el tamaño del disco cargado en pulgadas.
unidad de espacio en disco Devuelve el espacio en disco aproximado, en el formato de hora actual, que se puede obtener mediante un comando reserve para la unidad de disco especificada. Normalmente, la unidad se especifica como una sola letra o una sola letra seguida de dos puntos (:). Sin embargo, algunos dispositivos pueden usar una ruta de acceso.
tipo de división Devuelve uno de los siguientes tipos de división de archivos:
  • PPQN
  • Marco SMPTE 24
  • Marco SMPTE 25
  • Marco de colocación SMPTE 30
  • Marco SMPTE 30

Utilice esta información para determinar el formato del archivo MIDI y el significado de la información de tempo y posición.
finalización de archivos Devuelve el porcentaje estimado de una operación de carga, guardado, captura, corte, copia, eliminación, pegado o deshacer que ha progresado. (Las aplicaciones pueden usarlo para proporcionar un indicador visual del progreso).
formato del archivo Devuelve el formato de archivo actual para los comandos record o save .
modo de archivo Devuelve "loading", "saving", "editing" o "idle". Durante una operación de carga , devuelve "loading". Durante las operaciones de guardado y captura , devuelve "guardar". Durante las operaciones de cortar, copiar, eliminar, pegar o deshacer , devuelve "editing".
etiqueta de formato Devuelve la etiqueta de formato.
forward Devuelve TRUE si la dirección de reproducción está hacia delante o si el dispositivo no está reproduciendo.
velocidad de fotogramas Devuelve el número de fotogramas por segundo que el dispositivo usará de forma predeterminada. Los dispositivos NTSC devuelven 30, PAL 25, etc.
fotogramas omitidos Devuelve el número de fotogramas que no se dibujaron cuando se reproduzca la última secuencia AVI. Este indicador solo lo reconoce el controlador mciavi digital-video. Está pensado solo para la evaluación del rendimiento; el valor devuelto es difícil de interpretar.
gamma Devuelve el valor establecido con el valorsetvideo "gamma to".
índice Devuelve la presentación del índice actual. Para obtener más información, vea el comando set "index".
índice en Devuelve TRUE si el índice está activado.
input Devuelve el conjunto de entrada. Si no se establece uno, el error devuelto indica que se puede usar cualquier dispositivo. En el caso de los dispositivos de vídeo digital, modifica la marca "bass", "treble", "volume", "brightness", "color", "contrast", "gamma", "sharpness" o "tint" para que solo se aplique a la entrada. Este es el valor predeterminado al supervisar la entrada.
volumen izquierdo Devuelve el conjunto de volúmenes del canal de audio izquierdo.
length Devuelve la longitud total del medio, en el formato de hora actual. Para los archivos PPQN, la longitud se devuelve en unidades de puntero de canción. En el caso de los archivos SMPTE, se devuelve como hh:mm:ss:ff, donde hh es hours, mm es minutes, ss es seconds y ff es frames. En el caso de los dispositivos VCR, la longitud es de 2 horas (a menos que la longitud se haya cambiado explícitamente mediante el comando set ).
length track number (número de pista de longitud) Devuelve la longitud de la pista, en tiempo o fotogramas, especificado por número. Para los archivos PPQN, la longitud se devuelve en unidades de puntero de canción. En el caso de los archivos SMPTE, se devuelve como hh:mm:ss:ff, donde hh es hours, mm es minutes, ss es seconds y ff es frames.
Nivel Devuelve el valor de muestra de audio PCM actual.
maestro Devuelve "midi", "none" o "smpte" según el tipo de conjunto de sincronización.
medios presentes Devuelve TRUE si el medio se inserta en el dispositivo o FALSE en caso contrario. Los dispositivos sequencer, superposición de vídeo, vídeo digital y audio de forma de onda devuelven TRUE.
tipo de medio Devuelve el tipo del medio. Para VCRS, esto es "8mm", "vhs", "svhs", "beta", "Hi8", "edbeta" u "otro". En el caso de videodiscs, se trata de "CAV", "CLV" u "otros", según el tipo de videodisc.
mode Devuelve el modo actual del dispositivo. Todos los dispositivos pueden devolver los valores "no listos", "pausados", "reproduciendo" y "detenidos". Algunos dispositivos pueden devolver los valores adicionales "open", "parked", "recording" y "seeking".
monitor Devuelve "file" o "input". El valor devuelto indica el origen de presentación actual.
monitor (método) Devuelve "pre", "post" o "direct". El valor devuelto indica el método utilizado para la supervisión de entrada.
Nominal El elemento modifica las marcas "bass", "brightness", "color", "contrast", "gamma", "sharpness", "tint", "treble" y "volume" para devolver el valor nominal en lugar de la configuración actual.
velocidad nominal de fotogramas Devuelve la velocidad de fotogramas nominal asociada al archivo. Las unidades se encuentran en fotogramas por segundo multiplicadas por 1000.
velocidad nominal de fotogramas de registro Devuelve la velocidad de fotogramas nominal asociada a la señal de vídeo de entrada. Las unidades se encuentran en fotogramas por segundo multiplicadas por 1000.
número de pistas de audio Devuelve el número de pistas de audio en el medio.
número de pistas Devuelve el número de pistas en el medio. Los dispositivos MCISEQ y MCIWAVE devuelven 1, al igual que la mayoría de los dispositivos VCR. El dispositivo MCIPIONR no admite esta marca.
número de pistas de vídeo Devuelve el número de pistas de vídeo en el medio.
offset Devuelve el desplazamiento de un archivo basado en SMPTE. El desplazamiento es la hora de inicio de una secuencia basada en SMPTE. La hora se devuelve como hh:mm:ss:ff, donde hh es hours, mm es minutes, ss es seconds y ff es frames.
output Devuelve la salida establecida actualmente. Si no se establece ninguna salida, el error devuelto indica que se puede usar cualquier dispositivo. En el caso de los dispositivos de vídeo digital, modifica la marca "bass", "treble", "volume", "brightness", "color", "contrast", "gamma", "sharpness" o "tint" para que solo se aplique a la salida. Este es el valor predeterminado al supervisar un archivo.
modo de pausa Devuelve "grabación" si el dispositivo está en pausa durante la grabación. Devuelve "reproducción" si el dispositivo está en pausa mientras se reproduce. Devuelve el error "Acción no aplicable en modo actual" si el dispositivo no está en pausa.
pausar tiempo de espera Devuelve la duración máxima, en milisegundos, de un comando de pausa .
formato de reproducción Devuelve un código que indica el formato en el que se reproducirá la cinta de vídeo, si se puede detectar: "lp", "ep", "sp" u "otro". Para obtener más información, vea la marca "formato de registro".
velocidad de reproducción Devuelve un valor que representa el tiempo real de reproducción de la última secuencia AVI que coincide con el tiempo de reproducción de destino. El valor 1000 indica que la hora de destino y la hora real eran las mismas. Un valor de 2000, por ejemplo, indicaría que la secuencia AVI tardó dos veces en reproducirse como debería tener. Este indicador solo lo reconoce el controlador mciavi digital-video. Está pensado solo para la evaluación del rendimiento; el valor devuelto es difícil de interpretar.
port Devuelve el número de puerto MIDI asignado a la secuencia.
position Devuelve la posición actual. Para los archivos PPQN, la posición se devuelve en unidades de puntero de canción. En el caso de los archivos SMPTE, se devuelve como hh:mm:ss:ff, donde hh es hours, mm es minutes, ss es seconds y ff es frames.
comienzo de la posición Devuelve la posición del inicio del medio utilizable.
número de pista de posición Devuelve la posición del inicio de la pista especificada por número. En el caso de los archivos PPQN, el formato de hora se devuelve en unidades de puntero de canción. En el caso de los archivos SMPTE, se devuelve como hh:mm:ss:ff, donde hh es hours, mm es minutes, ss es seconds y ff es frames. El secuenciador MCISEQ devuelve cero. El dispositivo MCIPIONR no admite esta marca. El dispositivo MCIWAVE devuelve cero.
duración de la inscripción posterior Devuelve la longitud de la cinta de vídeo, en el formato de hora actual, necesario para detener el transporte de VCR cuando se emite un comando stop o pause .
encendido Devuelve TRUE si la alimentación del VCR está activada.
duración de la inscripción previa Devuelve la longitud de la cinta de vídeo, en el formato de hora actual, necesario para estabilizar la salida de VCR.
ready Devuelve TRUE si el dispositivo está listo para aceptar otro comando.
formato de registro Devuelve un código que indica el formato en el que se grabará la cinta de vídeo. Los tipos de valor devueltos actuales son "lp", "ep", "sp" u "other". Estos formatos no son específicos de VHS y se pueden aplicar a cualquier VCR que tenga varios formatos de grabación seleccionables. El tipo "sp" es el formato de grabación de mayor calidad y más rápido y se usa como valor predeterminado en los VCR de formato único.
velocidad de fotogramas de registro Devuelve la velocidad de fotogramas, en fotogramas por segundo multiplicado por 1000, que se usa para la compresión.
marco de referencia Devuelve el número de fotograma para la imagen de fotograma clave más cercana que precede al marco especificado.
tamaño reservado Devuelve el tamaño, en el formato de hora actual, del área de trabajo reservada. El tamaño corresponde al tiempo aproximado que se tardaría en reproducir los datos comprimidos de un área de trabajo completa. Devuelve cero si no hay espacio en disco reservado. Esta marca devuelve el tamaño aproximado porque el espacio en disco preciso para los datos comprimidos no se puede predecir, en general, hasta después de comprimir los datos.
volumen correcto Devuelve el conjunto de volúmenes para el canal de audio correcto.
samplespersec Devuelve el número de muestras por segundo reproducidas o grabadas.
buscar exactamente Devuelve "on" o "off", que indica si se ha establecido o no la marca "seek exactamente".
Nitidez Devuelve el nivel de nitidez actual del dispositivo.
Lado Devuelve 1 o 2 para indicar qué lado de la videodisc se carga.
Esclavo Devuelve "file", "midi", "none" o "smpte" según el tipo de conjunto de sincronización.
Smpte Devuelve el código de tiempo SMPTE asociado a la posición actual del área de trabajo. Se trata de una cadena con el formato dd:dd:dd:dd:dd, donde cada d denota un dígito de 0 a 9. Si los datos del área de trabajo no incluyen datos de código de tiempo, esta marca devuelve 00:00:00:00.00.
velocidad Devuelve la velocidad actual del dispositivo en fotogramas por segundo (o en el mismo formato usado por el comando set "speed"). El reproductor de videodisc MCIPIONR no admite esta marca.
posición inicial Devuelve la posición inicial del medio.
formato de archivo todavía Devuelve el formato de archivo actual para el comando capture .
ajustar Devuelve TRUE si la extensión está habilitada.
Tempo Devuelve el tempo actual de una secuencia MIDI en el formato de hora actual. En el caso de los archivos con formato PPQN, el tempo está en ritmos por minuto. En el caso de los archivos con formato SMPTE, el tempo está en fotogramas por segundo.
formato de hora Devuelve el formato de hora actual. Para obtener más información, vea los formatos de hora en el comando set .
modo de tiempo Devuelve el modo de tiempo de posición actual. Puede ser "detectar", "código de tiempo" o "contador".
tipo de hora Devuelve la hora de posición actual en uso: "código de tiempo" o "contador".
timecode present Devuelve TRUE si el código de tiempo se ha registrado en la posición actual de la cinta. El código de tiempo debe avanzar desde la posición actual. Es posible que sea necesario reproducir un VCR para comprobar esta condición.
registro de código de tiempo Devuelve TRUE si el VCR se establece en el código de tiempo de registro.
tipo de código de tiempo Devuelve "smpte", "smpte drop", "other" o "none". Tenga en cuenta que los fotogramas por segundo se pueden obtener del comando de estado "velocidad de fotogramas" y la precisión del dispositivo se puede devolver mediante el comando de funcionalidad "buscar precisión".
Tinte Devuelve el nivel actual de tono de vídeo.
Agudos Devuelve el nivel de audio-treble actual.
número de tóner Devuelve el número de tuner lógico actual.
Inconversos Devuelve TRUE si hay datos registrados en el área de trabajo que podrían perderse como resultado de un comando close, load, record, reserve, cut, delete o paste . Devuelve FALSE de lo contrario.
video Devuelve "on" o "off", que refleja el estado establecido por el comando setvideo .
color de clave de vídeo Devuelve el valor del color de la clave.
índice de clave de vídeo Devuelve el valor del índice de clave.
monitor de vídeo Devuelve "output" o uno de los tipos de entrada de origen válidos. Para obtener más información, vea el comando setvideo "monitor".
número de monitor de vídeo Devuelve el número de vídeo supervisado del tipo devuelto por el estado "monitor de vídeo". Para obtener más información, vea el comando setvideo .
grabación de vídeo Devuelve "on" o "off", que refleja el estado actual establecido por setvideo "record".
número de pista de grabación de vídeo Devuelve TRUE si el VCR está establecido en grabar vídeo. Si no se da ningún número de pista, se asume el valor predeterminado de 1.
origen de vídeo Devuelve el tipo de origen de vídeo. Para obtener más información, vea el comando setvideo .
número de origen de vídeo Devuelve un número correspondiente al origen de vídeo del tipo en uso. Por ejemplo, devuelve 2 si se usa la segunda entrada de origen de vídeo NTSC.
secuencia de vídeo Devuelve el número de secuencia de vídeo actual.
volumen Devuelve el volumen promedio al altavoz izquierdo y derecho. Esto devuelve un error si no se ha reproducido el dispositivo o no se ha establecido el volumen.
identificador de ventana Devuelve el valor decimal ASCII para el identificador de ventana en la palabra de orden bajo del valor devuelto.
ventana maximizada Devuelve TRUE si la ventana está maximizada.
ventana minimizada Devuelve TRUE si la ventana está minimizada.
ventana visible Devuelve TRUE si la ventana no está oculta.
escritura protegida Devuelve TRUE si el dispositivo detecta que no puede registrar (es decir, si la protección de escritura está activada). Si puede registrar o si no puede determinar si puede grabar (sin escribir realmente), el controlador devuelve FALSE.

lpszFlags

Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital y VCR, también se puede especificar "test". Para obtener más información sobre estas marcas, vea Las marcas Wait, Notify y Test.

Valor devuelto

Devuelve información en el parámetro lpszReturnString de mciSendString. La información depende del tipo de solicitud.

Comentarios

Antes de emitir los comandos que usen valores de posición, debe establecer el formato de hora deseado mediante el comando set .

Ejemplos

El siguiente comando devuelve el modo actual del dispositivo "mysound".

status mysound mode

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

capability

capturar

close

Cortar

delete

carga

pause

Pegar

record

reserva

guardar

set

setaudio

setvideo

stop

deshacer