comando MCI_RESTORE
O comando MCI_RESTORE copia um bitmap de um arquivo para o buffer de quadros. Os dispositivos de vídeo digital reconhecem esse comando. Esse comando executa a ação oposta do comando MCI_CAPTURE .
Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_RESTORE,
DWORD dwFlags,
(DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);
Parâmetros
-
wDeviceID
-
Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
-
lpRestore
-
Ponteiro para uma estrutura MCI_DGV_RESTORE_PARMS .
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
A implementação pode reconhecer uma variedade de formatos de imagem, mas um DIB (bitmap independente de dispositivo) do Windows é sempre aceito.
Os seguintes sinalizadores adicionais se aplicam a dispositivos de vídeo digital:
-
MCI_DGV_RESTORE_FROM
-
O membro lpstrFileName da estrutura identificada por lpRestore contém um endereço de um buffer que contém o nome do arquivo de origem. O nome do arquivo é necessário.
-
MCI_DGV_RESTORE_AT
-
O membro rc da estrutura identificada por lpRestore contém um retângulo válido. O retângulo especifica uma região do buffer de quadros em relação à sua origem. O primeiro par de coordenadas especifica o canto superior esquerdo do retângulo; o segundo par especifica a largura e a altura. Se esse sinalizador não for especificado, a imagem será copiada para o canto superior esquerdo do buffer de quadros.
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 |
|