Macros y mensajes de funciones MCI

[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.

La mayoría de las aplicaciones MCI usan las funciones mciSendString y mciSendCommand decenas de veces. MCI proporciona otras funciones útiles que la aplicación usará con menos frecuencia.

Normalmente, el identificador de dispositivo requerido por la mayoría de los comandos de MCI se recupera en una llamada al comando open (MCI_OPEN). Si necesita un identificador de dispositivo pero no desea abrir el dispositivo ( por ejemplo, si desea consultar las funcionalidades del dispositivo antes de realizar cualquier otra acción), puede llamar a la función mciGetDeviceID .

La función mciGetCreatorTask permite a la aplicación usar un identificador de dispositivo para recuperar un identificador a la tarea que creó ese identificador.

Puede usar las funciones mciGetYieldProc y mciSetYieldProc para asignar y recuperar la dirección de la función de devolución de llamada asociada a la marca "wait" (MCI_WAIT).

La función mciGetErrorString recupera una cadena que describe un valor de error de MCI. Cada cadena que devuelve MCI, ya sea datos o una descripción de error, es un máximo de 128 caracteres. Los campos de cuadro de diálogo con menos de 128 caracteres truncarán las cadenas más largas devueltas por MCI. Para obtener más información sobre estas cadenas, vea Valores devueltos de MCIERR.

Las macros de MCI son herramientas que puede usar para crear y desensamblar valores que especifican formatos de hora. Estos formatos de hora se usan en muchos comandos de MCI. Los formatos que actúan las macros son horas/minutos/segundos (HMS), minutos/segundos/fotogramas (MSF) y pistas/minutos/segundos/fotogramas (TMSF). En la tabla siguiente se enumeran las macros y sus descripciones.

Macro	Descripción
MCI_HMS_HOUR	Recupera el componente hours de un valor HMS.
MCI_HMS_MINUTE	Recupera el componente de minutos de un valor HMS.
MCI_HMS_SECOND	Recupera el componente de segundos de un valor HMS.
MCI_MAKE_HMS	Crea un valor HMS.
MCI_MAKE_MSF	Crea un valor MSF.
MCI_MAKE_TMSF	Crea un valor TMSF.
MCI_MSF_FRAME	Recupera el componente de fotogramas de un valor MSF.
MCI_MSF_MINUTE	Recupera el componente de minutos de un valor MSF.
MCI_MSF_SECOND	Recupera el componente de segundos de un valor MSF.
MCI_TMSF_FRAME	Recupera el componente de fotogramas de un valor TMSF.
MCI_TMSF_MINUTE	Recupera el componente de minutos de un valor TMSF.
MCI_TMSF_SECOND	Recupera el componente de segundos de un valor TMSF.
MCI_TMSF_TRACK	Recupera el componente de pistas de un valor TMSF.

 

MCI también proporciona dos mensajes: MM_MCINOTIFY y MM_MCISIGNAL. El mensaje MM_MCINOTIFY notifica a una aplicación el resultado de un comando MCI siempre que ese comando especifique la marca "notify" (MCI_NOTIFY). El mensaje MM_MCISIGNAL es específico de los dispositivos de vídeo digital; notifica a la aplicación cuando se alcanza una posición especificada.