Compartilhar via


comando load

O comando load carrega um arquivo em um formato específico do dispositivo. Dispositivos de sobreposição de vídeo digital e vídeo reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

_stprintf_s(
  lpszCommand, 
  TEXT("load %s %s %s"), 
  lpszDeviceID, 
  lpszFilePos, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszFilePos

Caminho e nome do arquivo a serem carregados. Para dispositivos de sobreposição de vídeo, isso também pode incluir um retângulo de destino para os dados. Para especificar um retângulo de destino, especifique "at" seguido por X1 Y1 X2 Y2, em que X1 Y1 especifica o canto superior esquerdo do retângulo e X2 Y2 especifique a largura e a altura. O retângulo é relativo à origem do buffer de vídeo.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital, "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

O dispositivo "vidboard" envia uma mensagem de notificação quando o carregamento é concluído.

Exemplos

O comando a seguir carrega um arquivo no dispositivo "vidboard".

load vidboard c:\vid\fish.vid notify

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]

Confira também

MCI

Cadeias de caracteres de comando MCI