comando capability

  • Artículo

El comando de funcionalidad solicita información sobre una funcionalidad determinada de un dispositivo. Todos los dispositivos MCI 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("capability %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 que identifica una funcionalidad del dispositivo. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando de funcionalidad y las marcas usadas por cada tipo:

Valor Tipo Tipo
cdaudio
  • puede expulsar
  • puede jugar
  • puede registrar
  • puede guardar
  • dispositivo compuesto
  • tipo de dispositivo
  • tiene audio
  • tiene vídeo
  • usa archivos
digitalvideo
  • puede expulsar
  • puede inmovilizar
  • puede bloquear
  • puede jugar
  • puede registrar
  • puede revertir
  • puede guardar
  • puede estirar
  • puede estirar la entrada
  • puede probar
  • dispositivo compuesto
  • tipo de dispositivo
  • tiene audio
  • Todavía
  • tiene vídeo
  • velocidad máxima de reproducción
  • velocidad mínima de reproducción
  • usa archivos
  • usa paletas
  • Windows
overlay
  • puede expulsar
  • puede inmovilizar
  • puede jugar
  • puede registrar
  • puede guardar
  • puede estirar
  • dispositivo compuesto
  • tipo de dispositivo
  • tiene audio
  • tiene vídeo
  • usa archivos
  • Windows
sequencer
  • puede expulsar
  • puede jugar
  • puede registrar
  • puede guardar
  • dispositivo compuesto
  • tipo de dispositivo
  • tiene audio
  • tiene vídeo
  • usa archivos
Vcr
  • puede detectar la longitud
  • puede expulsar
  • puede inmovilizar
  • puede supervisar orígenes
  • puede jugar
  • puede preinscribir
  • puede obtener una vista previa
  • puede registrar
  • puede revertir
  • puede guardar
  • puede probar
  • velocidad de incremento del reloj
  • dispositivo compuesto
  • tipo de dispositivo
  • tiene audio
  • tiene el reloj
  • tiene código de tiempo
  • tiene vídeo
  • número de marcas
  • precisión de búsqueda
  • usa archivos
Videodisco
  • puede expulsar
  • puede jugar
  • puede registrar
  • puede revertir
  • puede guardar
  • CAV
  • CLV
  • dispositivo compuesto
  • tipo de dispositivo
  • velocidad de reproducción rápida
  • tiene audio
  • tiene vídeo
  • velocidad de reproducción normal
  • velocidad de reproducción lenta
  • usa archivos
waveaudio
  • puede expulsar
  • se puede reproducir
  • puede registrar
  • puede guardar
  • dispositivo compuesto
  • tipo de dispositivo
  • tiene audio
  • tiene vídeo
  • inputs
  • outputs
  • usa archivos

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

Marcas Significado
puede detectar la longitud Devuelve TRUE si el dispositivo puede detectar la longitud del medio.
puede expulsar Devuelve TRUE si el dispositivo puede expulsar el medio.
puede inmovilizar Devuelve TRUE si el dispositivo puede inmovilizar los datos en el búfer de fotogramas.
puede bloquear Devuelve TRUE si el dispositivo puede bloquear los datos.
puede supervisar orígenes Devuelve TRUE si el dispositivo puede pasar una entrada (origen) a la salida supervisada, independientemente de la selección de entrada actual.
se puede reproducir Devuelve TRUE si el dispositivo puede reproducirse.
puede preinscribir Devuelve TRUE si el dispositivo admite la marca "preroll" con el comando cue .
puede obtener una vista previa Devuelve TRUE si el dispositivo admite vistas previas.
puede registrar Devuelve TRUE si el dispositivo admite la grabación.
puede invertir Devuelve TRUE si el dispositivo puede reproducirse a la inversa.
puede guardar Devuelve TRUE si el dispositivo puede guardar datos.
puede estirarse Devuelve TRUE si el dispositivo puede estirar fotogramas para rellenar un rectángulo de pantalla determinado.
puede ampliar la entrada Devuelve TRUE si el dispositivo puede cambiar el tamaño de una imagen en el proceso de digitalización en el búfer de fotogramas.
puede probar Devuelve TRUE si el dispositivo reconoce la palabra clave test.
Cav Cuando se combina con otros elementos, esta marca especifica que la información de devolución se aplica a videodiscs de formato CAV. Este es el valor predeterminado si no se inserta ningún videodisc.
velocidad de incremento de reloj Devuelve el número de subdivisiones que admite el reloj externo por segundo. Si el reloj externo es un reloj de milisegundos, el valor devuelto es 1000. Si el valor devuelto es 0, no se admite ningún reloj.
clv Cuando se combina con otros elementos, esta marca especifica que la información de retorno se aplica a videodiscs de formato CLV.
dispositivo compuesto Devuelve TRUE si el dispositivo admite un nombre de elemento (nombre de archivo).
tipo de dispositivo Devuelve un nombre de tipo de dispositivo, que puede ser uno de los siguientes:
  • cdaudio
  • dat
  • digitalvideo
  • otro
  • overlay
  • escáner
  • sequencer
  • Vcr
  • Videodisco
  • waveaudio
velocidad de reproducción rápida Devuelve la velocidad de reproducción rápida en fotogramas por segundo o cero si el dispositivo no puede reproducirse rápidamente.
tiene audio Devuelve TRUE si el dispositivo admite la reproducción de audio.
tiene reloj Devuelve TRUE si el dispositivo tiene un reloj.
Todavía Devuelve TRUE si el dispositivo trata los archivos con una sola imagen de forma más eficaz que los archivos de vídeo en movimiento.
tiene código de tiempo Devuelve TRUE si el dispositivo es capaz de admitir el código de tiempo o si es desconocido.
tiene vídeo Devuelve TRUE si el dispositivo admite vídeo.
inputs Devuelve el número total de dispositivos de entrada.
velocidad máxima de reproducción Devuelve la velocidad de reproducción máxima, en fotogramas por segundo, para el dispositivo.
velocidad mínima de reproducción Devuelve la velocidad de reproducción mínima, en fotogramas por segundo, para el dispositivo.
velocidad de reproducción normal Devuelve la velocidad de reproducción normal, en fotogramas por segundo, para el dispositivo.
número de marcas Devuelve el número máximo de marcas que se pueden usar; cero indica que no se admiten marcas.
outputs Devuelve el número total de dispositivos de salida.
precisión de búsqueda Devuelve la precisión esperada de una búsqueda en fotogramas; 0 indica que el dispositivo es preciso en el marco, 1 indica que el dispositivo espera estar dentro de un marco de la posición de búsqueda indicada, etc.
velocidad de reproducción lenta Devuelve la velocidad de reproducción lenta en fotogramas por segundo o cero si el dispositivo no puede reproducirse lentamente.
usa archivos Devuelve TRUE si el almacenamiento de datos utilizado por un dispositivo compuesto es un archivo.
usa paletas Devuelve TRUE si el dispositivo usa paletas.
Windows Devuelve el número de ventanas de visualización simultáneas que el dispositivo puede admitir.

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 la función mciSendString . La información depende del tipo de solicitud.

Ejemplos

El comando siguiente devuelve el tipo de dispositivo del dispositivo "mysound".

capability mysound device type

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

Cue