Mensagens de comando

[O recurso associado a esta página, MCI, é um recurso legado. Foi substituído por MediaPlayer. MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize MediaPlayer em vez de MCI, sempre que 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 é projetada para ser usada por aplicativos que exigem uma interface em 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çãomciSendCommand.

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

Sintaxe das mensagens de comando

As mensagens de comando MCI consistem nos seguintes elementos:

• Um valor de mensagem constante
• Uma estrutura contendo 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çãomciSendCommand 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 fornecido no primeiro parâmetro é recuperado quando o dispositivo é aberto usando o comando MCI_ OPEN. O último parâmetro é o endereço de uma estrutura dePARMSMCI_ PLAY_, que pode conter informações sobre onde começar e terminar 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 deMCINOTIFYMM_ quando a operação termina.