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