Mensagens de comando

[O recurso associado a esta página, MCI, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer em vez de MCI, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A interface de mensagem de comando foi projetada para ser usada por aplicativos que exigem uma interface de linguagem C para controlar dispositivos multimídia. Ele usa um paradigma de passagem de mensagens para se comunicar com dispositivos MCI. Você pode enviar um comando usando a função mciSendCommand .

A função mciSendCommand retornará zero se for bem-sucedida. Se a função falhar, a palavra de baixa ordem do valor retornado conterá um código de erro. Você pode passar esse código de erro para a função mciGetErrorString para obter uma descrição de texto do erro.

Sintaxe de mensagens de comando

As mensagens de comando MCI consistem nos seguintes elementos:

• Um valor de mensagem constante
• Uma estrutura que contém parâmetros para o comando
• Um conjunto de sinalizadores especificando opções para o comando e validando campos no bloco de parâmetros

O exemplo a seguir usa a função mciSendCommand para enviar o comando MCI_ PLAY para o dispositivo identificado por um identificador de dispositivo.

mciSendCommand(wDeviceID,            // device identifier 
    MCI_PLAY,                        // command message 
    0,                               // flags 
    (DWORD)(LPVOID) &mciPlayParms);  // parameter block 

O identificador de dispositivo dado no primeiro parâmetro é recuperado quando o dispositivo é aberto usando o comando MCI_ OPEN . O último parâmetro é o endereço de uma estrutura PARMS MCI_ PLAY_ , que pode conter informações sobre onde começar e encerrar a reprodução. Muitas mensagens de comando MCI usam uma estrutura para conter parâmetros desse tipo. O primeiro membro de cada uma dessas estruturas identifica a janela que recebe uma mensagem MCINOTIFY MM_ quando a operação é concluída.