Mensajes de comando
[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 interfaz de mensaje de comandos está diseñada para que la usen las aplicaciones que requieren una interfaz de lenguaje C para controlar los dispositivos multimedia. Usa un paradigma de paso de mensajes para comunicarse con dispositivos MCI. Puede enviar un comando mediante la función mciSendCommand .
La función mciSendCommand devuelve cero si se ejecuta correctamente. Si se produce un error en la función, la palabra de orden bajo del valor devuelto contiene un código de error. Puede pasar este código de error a la función mciGetErrorString para obtener una descripción de texto del error.
Sintaxis de mensajes de comando
Los mensajes de comando de MCI constan de los siguientes elementos:
- Valor de mensaje constante
- Estructura que contiene parámetros para el comando
- Un conjunto de marcas que especifican opciones para el comando y la validación de campos en el bloque de parámetros
En el ejemplo siguiente se usa la función mciSendCommand para enviar el comando MCI_ PLAY al dispositivo identificado por un identificador de dispositivo.
mciSendCommand(wDeviceID, // device identifier
MCI_PLAY, // command message
0, // flags
(DWORD)(LPVOID) &mciPlayParms); // parameter block
El identificador de dispositivo especificado en el primer parámetro se recupera cuando se abre el dispositivo mediante el comando MCI_ OPEN . El último parámetro es la dirección de una estructura parMS de MCI_ PLAY_ , que puede contener información sobre dónde comenzar y finalizar la reproducción. Muchos mensajes de comando de MCI usan una estructura para contener parámetros de este tipo. El primer miembro de cada una de estas estructuras identifica la ventana que recibe un mensaje de MM_ MCINOTIFY cuando finaliza la operación.