Compartir a través de

Clasificaciones de comandos de MCI

  • Artículo

[La característica asociada a esta página, MCI, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de MCI, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

MCI define cuatro clasificaciones de comandos: sistema, necesario, básico y extendido. En la lista siguiente se describen estas clasificaciones de comandos:

  • Los comandos del sistema se controlan directamente por MCI, en lugar de por el controlador.
  • El controlador controla los comandos necesarios. Todos los controladores de MCI deben admitir los comandos y marcas necesarios.
  • Algunos dispositivos usan comandos básicos (o comandos opcionales). Si un dispositivo admite un comando básico, debe admitir un conjunto definido de marcas para ese comando.
  • Los comandos extendidos son específicos de un tipo de dispositivo o controlador. Los comandos extendidos incluyen comandos, como los comandos put (MCI_PUT) y where (MCI_WHERE) para los tipos de dispositivo digitalvideo y overlay , y las extensiones a los comandos existentes (como la marca "stretch" del estado (MCI_STATUS) para el tipo de dispositivo superpuesto).

Aunque el sistema y los comandos necesarios son el conjunto de comandos mínimo para cualquier controlador MCI, todos los controladores no admiten comandos básicos y extendidos. La aplicación siempre puede usar el sistema y los comandos necesarios y sus marcas, pero si necesita usar un comando o marca básico o extendido, primero debe consultar al controlador mediante el comando de funcionalidad (MCI_GETDEVCAPS). En las secciones siguientes se resumen los comandos específicos de cada categoría.

Comandos del sistema

MCI procesa los siguientes comandos del sistema directamente, en lugar de pasarlos a dispositivos MCI.

String Message Descripción
Romper MCI_BREAK Establece una clave de interrupción para un dispositivo MCI.
Sysinfo MCI_SYSINFO Devuelve información sobre los dispositivos MCI.

 

Comandos necesarios

Todos los dispositivos MCI admiten los siguientes comandos necesarios.

String Message Descripción
Capacidad MCI_GETDEVCAPS Obtiene las funcionalidades de un dispositivo.
Cerca MCI_CLOSE Cierra el dispositivo.
Información MCI_INFO Obtiene información textual de un dispositivo.
Abierto MCI_OPEN Inicializa el dispositivo.
status MCI_STATUS Obtiene información de estado del dispositivo. Algunas de las marcas de este comando no son necesarias, por lo que también es un comando básico.

 

Los dispositivos también deben admitir un conjunto estándar de marcas de comandos para los comandos necesarios.

Comandos básicos

En la lista siguiente se resumen los comandos básicos. El uso de estos comandos por un dispositivo MCI es opcional.

String Message Descripción
carga MCI_LOAD Carga datos de un archivo.
Pausa MCI_PAUSE Deja de jugar. La reproducción o grabación se puede reanudar en la posición actual.
play MCI_PLAY Inicia la transmisión de datos de salida.
grabar MCI_RECORD Inicia la grabación de datos de entrada.
Reanudar MCI_RESUME Reanuda la reproducción o grabación en un dispositivo en pausa.
Salvar MCI_SAVE Guarda los datos en un archivo de disco.
Buscar MCI_SEEK Busca hacia delante o hacia atrás.
Establecer MCI_SET Establece el estado operativo del dispositivo.
status ESTADO DE MCI Obtiene información de estado sobre el dispositivo. Esto también es un comando obligatorio; puesto que algunas de sus marcas no son necesarias, también se muestra aquí. (Los elementos opcionales admiten dispositivos que usan medios lineales con posiciones identificables).
Parada MCI_STOP Deja de jugar.

 

Si un controlador admite un comando básico, también debe admitir un conjunto estándar de marcas para el comando.

Comandos extendidos

Algunos dispositivos MCI tienen comandos adicionales o agregan marcas a los comandos existentes. Aunque algunos comandos extendidos solo se aplican a un controlador de dispositivo específico, la mayoría de ellos se aplican a todos los controladores de un tipo de dispositivo determinado. Por ejemplo, el conjunto de comandos para el tipo de dispositivo secuenciador amplía el comando set (MCI_SET) para agregar formatos de tiempo que necesitan los secuenciadores MIDI.

No debe suponer que el dispositivo admite los comandos extendidos o las marcas. Puede usar el comando de funcionalidad (MCI_GETDEVCAPS) para determinar si se admite una característica específica y la aplicación debe estar lista para tratar los valores devueltos "comando no admitido" o "función no admitida".

Los siguientes comandos extendidos están disponibles con los tipos de dispositivo enumerados.

String Mensaje Tipos de dispositivos Descripción
CONFIGURAR MCI_CONFIGURE digitalvideo Muestra un cuadro de diálogo de configuración.
Cue MCI_CUE digitalvideo, waveaudio Se prepara para reproducir o grabar.
Eliminar MCI_DELETE waveaudio Elimina un segmento de datos del archivo multimedia.
escape MCI_ESCAPE Videodisco Envía información personalizada a un dispositivo.
Congelar MCI_FREEZE overlay Deshabilita la adquisición de vídeo en el búfer de fotogramas.
Poner MCI PUT digitalvideo, superposición Define las ventanas de origen, destino y marco.
darse cuenta de MCI_REALIZE digitalvideo Indica al dispositivo que seleccione y se dé cuenta de su paleta en un contexto de dispositivo de la ventana mostrada.
setaudio MCI_ SETAUDIO digitalvideo Establece los parámetros de audio para el vídeo.
setvideo MCI_ SETVIDEO digitalvideo Establece parámetros de vídeo.
signal MCI_SIGNAL digitalvideo Identifica una posición especificada con una señal.
giro MCI_SPIN Videodisco Inicia el disco girando o impide que el disco gire.
Paso MCI_STEP digitalvideo, videodisc Ejecuta uno o varios fotogramas hacia delante o inverso.
Descongelar MCI_UNFREEZE overlay Permite que el búfer de fotogramas adquiera datos de vídeo.
actualizar MCI_UPDATE digitalvideo Vuelve a dibujar el marco actual en el contexto del dispositivo.
Dónde MCI WHERE digitalvideo, superposición Obtiene el rectángulo que especifica el área de origen, destino o marco.
Ventana MCI_WINDOW digitalvideo, superposición Controla la ventana de presentación.