Compartilhar via

comando MCI_SETVIDEO

  • Artigo

O comando MCI_SETVIDEO define valores associados à reprodução de vídeo. Os dispositivos de vídeo digital e VCR reconhecem esse comando.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

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.

lpSetVideo

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 Retornado

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_SETVIDEO_ALG

O membro lpstrAlgorithm da estrutura identificada por lpSetVideo contém um endereço de um buffer que contém o nome de um algoritmo de compactação de vídeo. O algoritmo de compactação é usado por comandos MCI_RESERVE ou MCI_RECORD subsequentes. Os algoritmos disponíveis dependem do dispositivo.

Se o algoritmo especificado for incompatível com o formato de arquivo atual, o formato do arquivo será alterado para o formato padrão do algoritmo.

MCI_DGV_SETVIDEO_CLOCKTIME

Quando usado com MCI_DGV_SETVIDEO_OVER, indica que o tempo é especificado em milissegundos e é tempo absoluto. (Esse tempo não está em etapa com a reprodução do workspace.)

MCI_DGV_SETVIDEO_INPUT

Modifica o MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS ou MCI_DGV_SETVIDEO_TINT para que ele afete o sinal de entrada e modifique o que é registrado. Se possível, esse é o padrão ao monitorar a entrada.

MCI_DGV_SETVIDEO_ITEM

Uma constante de vídeo é especificada no membro dwItem da estrutura identificada por lpSetVideo. A constante identifica o valor que está sendo definido. Você pode especificar as seguintes constantes com este sinalizador:

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

Um novo endereço de procedimento de desenho é especificado no membro dwValue da estrutura identificada por lpSetVideo. Você pode especificar um novo procedimento de desenho somente quando o dispositivo estiver ocioso. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI. Não há equivalente a esse sinalizador na interface de comando da cadeia de caracteres.

MCI_AVI_SETVIDEO_PALETTE_COLOR

Uma nova cor de paleta é especificada nos membros dwOver e dwValue da estrutura identificada por lpSetVideo. O membro dwOver especifica o índice de paleta da cor a ser alterada e o membro dwValue especifica a nova cor, como um valor RGB. Você também deve especificar os sinalizadores MCI_DGV_SETVIDEO_OVER e MCI_DGV_SETVIDEO_VALUE com MCI_DGV_SETVIDEO_ITEM ao usar essa constante. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI.

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

Indica que a paleta de meio tom deve ser usada, em vez da paleta padrão. Esse sinalizador é reconhecido apenas pelo driver de vídeo digital MCIAVI.

MCI_DGV_SETVIDEO_BITSPERPEL

O número de bits por pixel é especificado no membro dwValue da estrutura identificada por lpSetVideo. O número de bits por pixel é usado para salvar dados capturados ou gravados

MCI_DGV_SETVIDEO_BRIGHTNESS

O nível de brilho do vídeo é especificado como um fator no membro dwValue da estrutura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_COLOR

O nível de saturação de cor de vídeo é especificado como um fator no membro dwValue da estrutura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_CONTRAST

O nível de contraste de vídeo é especificado como um fator no membro dwValue da estrutura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_FRAME_RATE

Uma taxa de quadros é especificada no membro dwValue da estrutura identificada por lpSetVideo. A taxa é especificada em unidades de quadros por segundo vezes 1000. Por exemplo, 29,97 quadros por segundo são especificados como 29970.

MCI_DGV_SETVIDEO_GAMMA

Um valor expoente de correção gama é especificado no membro dwValue da estrutura identificada por lpSetVideo. A correção gama ajusta o mapeamento entre a intensidade codificada na origem da apresentação e o brilho exibido. O valor é o expoente multiplicado por 1000. Por exemplo, 2200 indica um expoente 2.2. Um valor de 1000 indica um expoente de 1, que não aplica nenhuma correção gama.

MCI_DGV_SETVIDEO_KEY_COLOR

Uma cor de chave é especificada no membro dwValue da estrutura identificada por lpSetVideo. A cor da chave é um valor RGB.

MCI_DGV_SETVIDEO_KEY_INDEX

Um valor de índice de chave é especificado no membro dwValue da estrutura identificada por lpSetVideo. O parâmetro index é um índice de paleta física.

MCI_DGV_SETVIDEO_PALHANDLE

Um identificador de paleta é especificado no membro dwValue da estrutura identificada por lpSetVideo. O identificador de paleta está contido na palavra de baixa ordem. Os dispositivos de vídeo digital não devem liberar a paleta passada com esse comando. Os aplicativos devem liberá-lo depois de fecharem o dispositivo. Esse sinalizador tem suporte apenas para dispositivos que usam paletas. Se esse identificador de paleta especificado for zero, a paleta padrão será usada.

MCI_DGV_SETVIDEO_SHARPNESS

Um valor de nitidez de vídeo é especificado como um fator no membro dwValue da estrutura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_SOURCE

Uma constante que especifica a origem da entrada de vídeo é especificada no membro dwValue da estrutura identificada por lpSetVideo. As seguintes constantes são definidas:

  • MCI_DGV_SETVIDEO_SRC_NTSC: televisão NTSC.
  • MCI_DGV_SETVIDEO_SRC_PAL: televisão PAL.
  • MCI_DGV_SETVIDEO_SRC_RGB: vídeo RGB.
  • MCI_DGV_SETVIDEO_SRC_SECAM: televisão SECAM.
  • MCI_DGV_SETVIDEO_SRC_SVIDEO: S-Video.

MCI_DGV_SETVIDEO_STREAM

Um fluxo de vídeo é especificado no membro dwValue da estrutura identificada por lpSetVideo. O valor inteiro especifica o fluxo de vídeo reproduzido do workspace. Se o fluxo não for especificado e o formato de arquivo não definir um fluxo padrão, o primeiro fluxo de vídeo fisicamente intercalado será reproduzido.

MCI_DGV_SETVIDEO_TINT

Um valor de tonalidade de vídeo é especificado como um fator no membro dwValue da estrutura identificada por lpSetVideo. Normalmente, esse ajuste é modelado após o controle de tonalidade de muitos conjuntos de televisão de cores, com 250 definidos como verde, 750 definidos como vermelho e 0 (ou 1000) definidos como azul. O valor nominal é sempre 500.

MCI_DGV_SETVIDEO_OUTPUT

O sinalizador MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS ou MCI_DGV_SETVIDEO_TINT é modificado para que ele afete apenas o sinal exibido e não o que é registrado. Se possível, esse é o padrão ao monitorar um arquivo.

MCI_DGV_SETVIDEO_OVER

Um parâmetro de comprimento de transição é incluído no membro dwOver da estrutura identificada por lpSetVideo. O comprimento da transição especifica quanto tempo (no formato de hora atual) deve levar para fazer uma alteração. Se esse sinalizador não for usado, a alteração ocorrerá imediatamente.

MCI_DGV_SETVIDEO_QUALITY

O membro lpstrQuality da estrutura identificada por lpSetVideo contém um endereço de um buffer que descreve a qualidade do vídeo. Uma cadeia de caracteres de texto no buffer especifica as características do algoritmo de compactação de vídeo.

O sinalizador MCI_DGV_SETVIDEO_ALG pode ser usado para selecionar um descritor de qualidade para o algoritmo especificado. Se esse sinalizador for omitido, o algoritmo atual será usado.

Os algoritmos e nomes de descritor disponíveis dependem do dispositivo. Cada dispositivo fornece documentação para os algoritmos disponíveis e uma descrição dos nomes de descritor aplicáveis. O comando MCI_QUALITY pode definir nomes de descritores adicionais. Todos os dispositivos dão suporte aos descritores "baixo", "médio" e "alto". O padrão é específico do driver.

MCI_DGV_SETVIDEO_RECORD

Especifica se a gravação inclui ou exclui dados de vídeo. Quando combinados com MCI_SET_ON, os dados de vídeo são gravados. Quando combinados com MCI_SET_OFF, os dados de vídeo são excluídos. O padrão inclui dados de vídeo.

MCI_DGV_SETVIDEO_SRC_NUMBER

Um número para a fonte de vídeo é especificado no membro dwSourceNumber da estrutura identificada por lpSetVideo. Se houver mais de uma entrada do tipo especificado por MCI_DGV_SETVIDEO_VALUE, o valor selecionará a entrada. Esse sinalizador sempre deve ser usado com MCI_DGV_SETVIDEO_SOURCE. No entanto, se MCI_DGV_SETVIDEO_VALUE for omitido, o número de origem especificado indicará a fonte absoluta a ser usada conforme especificado no comando MCI_LIST .

MCI_DGV_SETVIDEO_STILL

O nome do algoritmo ou o valor de qualidade especificado se aplica a imagens paradas.

Cada driver de dispositivo deve dar suporte a um algoritmo de "nenhum", o que significa que não há compactação. Esse é o padrão. Nesse caso, os dispositivos de vídeo digital salvam imagens paradas como DIBs (bitmaps independentes de dispositivo) RGB.

MCI_DGV_SETVIDEO_VALUE

Um valor é incluído no membro dwValue da estrutura identificada por lpSetVideo. O significado do valor é especificado pelo sinalizador MCI_DGV_SETVIDEO_ITEM .

MCI_SET_OFF

Desabilita a saída do vídeo. Para dispositivos de vídeo digital, desabilitar o vídeo define os pixels no retângulo de destino definido pelo comando MCI_PUT (ou seu padrão, a região do cliente da janela atual) para uma cor sólida, mas não tem efeito sobre o buffer de quadros. Você pode ocultar a janela com o comando MCI_WINDOW , se desejado. A origem do vídeo, seja o workspace ou uma entrada externa, pode continuar a armazenar novas imagens no buffer de quadros, mas elas não são exibidas até que o vídeo esteja habilitado. Embora os aplicativos devam usar o comando MCI_SETVIDEO para controlar essa função, os dispositivos de vídeo digital ainda devem dar suporte a esse sinalizador. O valor padrão depois de abrir está ativado.

MCI_SET_ON

Habilita a saída de vídeo.

Para dispositivos de vídeo digital, o parâmetro lpSetVideo aponta para uma estrutura MCI_DGV_SETVIDEO_PARMS .

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

MCI_VCR_SETVIDEO_RECORD

Define a gravação de vídeo como ativada ou desativada. Usado em conjunto com um dos seguintes sinalizadores:

  • MCI_SET_ON. Gravação de vídeo ativada.
  • MCI_SET_OFF. Gravação de vídeo desativada. Talvez seja necessário primeiro desativar a gravação de montagem (usando o comando MCI_SET com o sinalizador MCI_VCR_SET_ASSEMBLE_RECORD definido como desativado) antes que a gravação de vídeo possa ser desativada.

MCI_TRACK

O membro dwTrack da estrutura identificada por lpSetVideo especifica qual faixa é afetada pelo comando.

MCI_VCR_SETVIDEO_SOURCE

Define a origem do vídeo e deve ser usado com o sinalizador MCI_VCR_SETVIDEO_TO .

MCI_VCR_SETVIDEO_MONITOR

Define o monitor de origem do vídeo e deve ser usado com o sinalizador MCI_VCR_SETVIDEO_TO.

MCI_VCR_SETVIDEO_TO

O membro dwTo da estrutura identificada por lpSetVideo contém uma das seguintes constantes:

**MCI\_VCR\_SRC\_TYPE\_TUNER**
**MCI\_VCR\_SRC\_TYPE\_LINE**
**MCI\_VCR\_SRC\_TYPE\_AUX**
**MCI\_VCR\_SRC\_TYPE\_GENERIC**
**MCI\_VCR\_SRC\_TYPE\_MUTE**
**MCI\_VCR\_SRC\_TYPE\_OUTPUT**
**MCI\_VCR\_SRC\_TYPE\_RGB**
**MCI\_VCR\_SETVIDEO\_NUMBER**

O membro dwNumber da estrutura identificada por lpSetVideo contém a entrada de vídeo (do tipo especificado no membro dwTo ) a ser usado.

Para dispositivos VCR, o parâmetro lpSetVideo aponta para uma estrutura MCI_VCR_SETVIDEO_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 (incluir Windows.h)

Confira também

MCI

Comandos MCI