comando MCI_PUT

O comando MCI_PUT define os retângulos de origem, destino e quadro. 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_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

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.

lpDest

Ponteiro para uma estrutura MCI_GENERIC_PARMS . (Dispositivos com conjuntos de comandos estendidos podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Valor de retorno

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

Comentários

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo digitalvideo :

MCI_DGV_PUT_CLIENT

O retângulo definido para MCI_DGV_RECT se aplica à posição da janela do cliente. O retângulo especificado é relativo à janela pai da janela de exibição. MCI_DGV_PUT_WINDOW deve ser definido simultaneamente com esse sinalizador.

MCI_DGV_PUT_DESTINATION

O retângulo definido para MCI_DGV_RECT especifica um retângulo de destino. O retângulo de destino especifica a parte da janela do cliente associada a essa instância de driver de dispositivo que mostra a imagem ou o vídeo.

MCI_DGV_PUT_FRAME

O retângulo definido para MCI_DGV_RECT se aplica ao retângulo de quadro. O retângulo de quadro especifica a parte do buffer de quadro usado como o destino das imagens de vídeo obtidas do retângulo de vídeo. O vídeo deve ser dimensionado para caber dentro do retângulo do buffer de quadro.

O retângulo é especificado em coordenadas de buffer de quadro. O retângulo padrão é o buffer de quadro completo. Especificar esse retângulo permite que o dispositivo dimensione a imagem à medida que digitaliza os dados. Dispositivos que não podem dimensionar a imagem rejeitam esse comando com MCIERR_UNSUPPORTED_FUNCTION. Você pode usar o sinalizador MCI_GETDEVCAPS_CAN_STRETCH com o comando MCI_GETDEVCAPS para determinar se um dispositivo dimensiona a imagem. Um dispositivo retornará FALSE se não puder dimensionar a imagem.

MCI_DGV_PUT_SOURCE

O retângulo definido para MCI_DGV_RECT especifica um retângulo de origem. O retângulo de origem especifica qual parte do buffer de quadro deve ser dimensionada para caber no retângulo de destino.

MCI_DGV_PUT_VIDEO

O retângulo definido para MCI_DGV_RECT se aplica ao retângulo de vídeo. O retângulo de vídeo especifica qual parte da origem da apresentação atual está armazenada no buffer de quadros. O retângulo é especificado usando as coordenadas naturais da origem da apresentação. Ele permite a especificação de corte que ocorre antes de armazenar imagens e vídeos no buffer de quadros. O retângulo padrão é a área de verificação ativa completa ou as imagens e vídeos descompactados completos.

MCI_DGV_PUT_WINDOW

O retângulo definido para MCI_DGV_RECT se aplica à janela de exibição. Esse retângulo é relativo à janela pai da janela de exibição (geralmente a área de trabalho). Se a janela não for especificada, ela usará como padrão o tamanho e a posição da janela inicial.

MCI_DGV_RECT

O membro rc da estrutura identificado pelo lpDest contém um retângulo válido.

Para dispositivos de vídeo digital, o lpDest aponta para uma estrutura de MCI_DGV_PUT_PARMS .

Os seguintes sinalizadores adicionais são usados com o tipo de dispositivo de sobreposição :

MCI_OVLY_PUT_DESTINATION

O retângulo definido para MCI_OVLY_RECT especifica a área da janela do cliente usada para exibir uma imagem. O retângulo contém o deslocamento e a extensão visível da imagem em relação à origem da janela. Se o quadro estiver sendo estendido, a origem será estendida para o retângulo de destino.

MCI_OVLY_PUT_FRAME

O retângulo definido para MCI_OVLY_RECT especifica a área do buffer de vídeo usado para receber a imagem de vídeo. O retângulo contém o deslocamento e a extensão da área de buffer em relação à origem do buffer de vídeo.

MCI_OVLY_PUT_SOURCE

O retângulo definido para MCI_OVLY_RECT especifica a área do buffer de vídeo usada como a origem da imagem digital. O retângulo contém o deslocamento e a extensão do retângulo de recorte para o buffer de vídeo em relação à sua origem.

MCI_OVLY_PUT_VIDEO

O retângulo definido para MCI_OVLY_RECT especifica a área da captura de origem do vídeo pelo buffer de vídeo. O retângulo contém o deslocamento e a extensão do retângulo de recorte para a fonte de vídeo em relação à sua origem.

MCI_OVLY_RECT

O membro rc da estrutura identificado pelo lpDest contém um retângulo de exibição válido. Se esse sinalizador não for especificado, o retângulo padrão corresponderá às coordenadas do buffer de vídeo ou da janela que está sendo cortada.

Para dispositivos de sobreposição de vídeo, o lpDest aponta para uma estrutura de MCI_OVLY_RECT_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