Macros e mensagens do MCI Functions

[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 maioria dos aplicativos MCI usa as funções mciSendString e mciSendCommand dezenas de vezes. O MCI fornece algumas outras funções úteis que seu aplicativo usará com menos frequência.

O identificador de dispositivo exigido pela maioria dos comandos MCI normalmente é recuperado em uma chamada para o comando open (MCI_OPEN). Se você precisar de um identificador de dispositivo, mas não quiser abrir o dispositivo , por exemplo, se quiser consultar os recursos do dispositivo antes de executar qualquer outra ação, poderá chamar a função mciGetDeviceID .

A função mciGetCreatorTask permite que seu aplicativo use um identificador de dispositivo para recuperar um identificador para a tarefa que criou esse identificador.

Você pode usar as funções mciGetYieldProc e mciSetYieldProc para atribuir e recuperar o endereço da função de retorno de chamada associada ao sinalizador "wait" (MCI_WAIT).

A função mciGetErrorString recupera uma cadeia de caracteres que descreve um valor de erro MCI. Cada cadeia de caracteres que o MCI retorna, seja dados ou uma descrição de erro, é um máximo de 128 caracteres. Os campos da caixa de diálogo menores que 128 caracteres truncarão as cadeias de caracteres mais longas retornadas pelo MCI. Para obter mais informações sobre essas cadeias de caracteres, consulte Valores retornados do MCIERR.

As macros MCI são ferramentas que você pode usar para criar e desmontar valores que especificam formatos de tempo. Esses formatos de tempo são usados em muitos comandos MCI. Os formatos atuados pelas macros são horas/minutos/segundos (HMS), minutos/segundos/quadros (MSF) e faixas/minutos/segundos/quadros (TMSF). A tabela a seguir lista as macros e suas descrições.

Macro	Descrição
MCI_HMS_HOUR	Recupera o componente de horas de um valor HMS.
MCI_HMS_MINUTE	Recupera o componente de minutos de um valor HMS.
MCI_HMS_SECOND	Recupera o componente de segundos de um valor HMS.
MCI_MAKE_HMS	Cria um valor HMS.
MCI_MAKE_MSF	Cria um valor MSF.
MCI_MAKE_TMSF	Cria um valor TMSF.
MCI_MSF_FRAME	Recupera o componente frames de um valor MSF.
MCI_MSF_MINUTE	Recupera o componente de minutos de um valor MSF.
MCI_MSF_SECOND	Recupera o componente de segundos de um valor MSF.
MCI_TMSF_FRAME	Recupera o componente frames de um valor TMSF.
MCI_TMSF_MINUTE	Recupera o componente de minutos de um valor TMSF.
MCI_TMSF_SECOND	Recupera o componente de segundos de um valor TMSF.
MCI_TMSF_TRACK	Recupera o componente de faixas de um valor TMSF.

 

O MCI também fornece duas mensagens: MM_MCINOTIFY e MM_MCISIGNAL. A mensagem MM_MCINOTIFY notifica um aplicativo do resultado de um comando MCI sempre que esse comando especifica o sinalizador "notify" (MCI_NOTIFY). A mensagem MM_MCISIGNAL é específica para dispositivos de vídeo digital; ele notifica o aplicativo quando uma posição especificada é atingida.