Estrutura COMPVARS (vfw.h)

Artigo
03/13/2024

A estrutura COMPVARS descreve as configurações do compressor para funções como ICCompressorChoose, ICSeqCompressFrame e ICCompressorFree.

Sintaxe

typedef struct {
  LONG         cbSize;
  DWORD        dwFlags;
  HIC          hic;
  DWORD        fccType;
  DWORD        fccHandler;
  LPBITMAPINFO lpbiIn;
  LPBITMAPINFO lpbiOut;
  LPVOID       lpBitsOut;
  LPVOID       lpBitsPrev;
  LONG         lFrame;
  LONG         lKey;
  LONG         lDataRate;
  LONG         lQ;
  LONG         lKeyCount;
  LPVOID       lpState;
  LONG         cbState;
} COMPVARS, *PCOMPVARS;

Membros

cbSize

Tamanho, em bytes, dessa estrutura. Esse membro deve ser definido para validar a estrutura antes de chamar qualquer função usando essa estrutura.

dwFlags

Sinalizadores aplicáveis. O seguinte valor é definido:

Nome	Descrição
ICMF_COMPVARS_VALID	Os dados nessa estrutura são válidos e foram inseridos manualmente. Defina esse sinalizador antes de chamar qualquer função se você preencher essa estrutura manualmente. Não defina esse sinalizador se você permitir que ICCompressorChoose inicialize essa estrutura.

hic

Manipule para o compressor a ser usado. Você pode abrir um compressor e obter um identificador dele usando a função ICOpen . Você também pode escolher um compressor usando ICCompressorChoose. ICCompressorChoose abre o compressor escolhido e retorna o identificador do compressor neste membro. Você pode fechar o compressor usando ICCompressorFree.

fccType

Tipo de compressor usado. Atualmente, há suporte apenas ICTYPE_VIDEO (VIDC). Esse membro pode ser definido como zero.

fccHandler

Código de quatro caracteres do compressor. Especifique NULL para indicar que os dados não devem ser compactados novamente. Especifique "DIB" para indicar que os dados são um quadro completo e descompactado. Você pode usar esse membro para especificar qual compressor é selecionado por padrão quando a caixa de diálogo é exibida.

lpbiIn

Reservado; não use.

lpbiOut

Ponteiro para uma estrutura BITMAPINFO que contém o formato de saída da imagem. Você pode especificar um formato específico a ser usado ou especificar NULL para usar o compressor padrão associado ao formato de entrada. Você também pode definir o formato de saída da imagem usando ICCompressorChoose.

lpBitsOut

Reservado; não use.

lpBitsPrev

Reservado; não use.

lFrame

Reservado; não use.

lKey

Taxa de quadros-chave. Especifique um inteiro para indicar a frequência que os quadros-chave devem ocorrer na sequência compactada ou zero para não usar quadros-chave. Você também pode permitir que ICCompressorChoose defina a taxa de quadros-chave selecionada na caixa de diálogo. A função ICSeqCompressFrameStart usa o valor desse membro para criar quadros-chave.

lDataRate

Taxa de dados, em quilobytes por segundo. ICCompressorChoose copia a taxa de dados selecionada da caixa de diálogo para esse membro.

lQ

Configuração de qualidade. Especifique uma configuração de qualidade de 1 a 10.000 ou especifique ICQUALITY_DEFAULT para usar a configuração de qualidade padrão. Você também pode permitir que ICCompressorChoose defina o valor de qualidade selecionado na caixa de diálogo. ICSeqCompressFrameStart usa o valor desse membro como sua configuração de qualidade.

lKeyCount

Reservado; não use.

lpState

Reservado; não use.

cbState

Reservado; não use.

Comentários

Você pode permitir que ICCompressorChoose preencha o conteúdo dessa estrutura ou faça isso manualmente. Se você preencher manualmente a estrutura, deverá fornecer informações para os seguintes membros: cbSize, hic, lpbiOut, lKey e lQ. Além disso, você deve definir o sinalizador ICMF_COMPVARS_VALID no membro dwFlags .

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	vfw.h