comando MCI_LOAD

O comando MCI_LOAD carrega um arquivo. Os dispositivos de sobreposição de vídeo digital e vídeo reconhecem esse comando.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_LOAD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_LOAD_PARMS) lpLoad
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpLoad

Ponteiro para uma estrutura MCI_LOAD_PARMS . (Dispositivos com parâmetros adicionais podem substituir essa estrutura por uma estrutura específica do dispositivo. Para dispositivos de vídeo digital, o parâmetro lpLoad aponta para uma estrutura MCI_DGV_LOAD_PARMS .)

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

O seguinte sinalizador adicional se aplica a todos os dispositivos que dão suporte a MCI_LOAD:

MCI_LOAD_FILE

O membro lpfilename da estrutura identificada pelo lpLoad contém um endereço de um buffer que contém o nome do arquivo.

O seguinte sinalizador adicional é usado com o tipo de dispositivo de sobreposição :

MCI_OVLY_RECT

O membro rc da estrutura identificada pelo lpLoad contém um retângulo de exibição válido que identifica a área do buffer de vídeo a ser atualizada.

Para dispositivos de sobreposição de vídeo, o parâmetro lpLoad aponta para uma estrutura MCI_OVLY_LOAD_PARMS .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Mmsystem.h (inclua Windows.h)

Confira também

MCI

Comandos MCI