comando restore

O comando restore copia uma imagem parada de um arquivo para o buffer de quadros. Esse é o inverso do comando de captura . Os dispositivos de vídeo digital 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("restore %s %s %s"), 
  lpszDeviceID, 
  lpszRestore, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

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

lpszRestore

Um ou mais dos sinalizadores a seguir.

Valor	Significado
no retângulo	Especifica um retângulo relativo à origem do buffer de quadro. O retângulo é especificado como X1 Y1 X2 Y2. As coordenadas X1 Y1 especificam o canto superior esquerdo e as coordenadas X2 Y2 especificam a largura e a altura. Se esse sinalizador não for usado, a imagem será copiada para o canto superior esquerdo do buffer de quadros.
de filename	Especifica o nome do arquivo de imagem a ser recuperado. Este sinalizador é necessário.

lpszFlags

Pode ser "wait", "notify", "test" ou uma combinação deles. 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

Os dispositivos podem reconhecer uma variedade de formatos de imagem; um bitmap independente do dispositivo Windows é sempre reconhecido.

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

Capturar