Estructura COMPVARS (vfw.h)

Artículo
08/27/2023

La estructura COMPVARS describe la configuración del compresor para funciones como ICCompressorChoose, ICSeqCompressFrame e ICCompressorFree.

Sintaxis

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;

Miembros

cbSize

Tamaño, en bytes, de esta estructura. Este miembro debe establecerse para validar la estructura antes de llamar a cualquier función mediante esta estructura.

dwFlags

Marcas aplicables. Se define el siguiente valor:

Nombre	Descripción
ICMF_COMPVARS_VALID	Los datos de esta estructura son válidos y se han escrito manualmente. Establezca esta marca antes de llamar a cualquier función si rellena esta estructura manualmente. No establezca esta marca si permite que ICCompressorChoose inicialice esta estructura.

hic

Asa al compresor que se va a utilizar. Puede abrir un compresor y obtener un asa mediante la función ICOpen . También puede elegir un compresor mediante ICCompressorChoose. ICCompressorChoose abre el compresor elegido y devuelve el mango del compresor en este miembro. Puede cerrar el compresor mediante ICCompressorFree.

fccType

Tipo de compresor utilizado. Actualmente solo se admite ICTYPE_VIDEO (VIDC). Este miembro se puede establecer en cero.

fccHandler

Código de cuatro caracteres del compresor. Especifique NULL para indicar que los datos no se van a volver a comprimir. Especifique "DIB" para indicar que los datos son un marco completo sin comprimir. Puede utilizar este miembro para especificar qué compresor está seleccionado de forma predeterminada cuando se muestra el cuadro de diálogo.

lpbiIn

Reservado; no usar.

lpbiOut

Puntero a una estructura BITMAPINFO que contiene el formato de salida de la imagen. Puede especificar un formato específico que se usará o puede especificar NULL para usar el compresor predeterminado asociado al formato de entrada. También puede establecer el formato de salida de la imagen mediante ICCompressorChoose.

lpBitsOut

Reservado; no usar.

lpBitsPrev

Reservado; no usar.

lFrame

Reservado; no usar.

lKey

Velocidad de fotogramas clave. Especifique un entero para indicar la frecuencia con la que se van a producir fotogramas clave en la secuencia comprimida o cero para no usar fotogramas clave. También puede permitir que ICCompressorChoose establezca la velocidad de fotograma clave seleccionada en el cuadro de diálogo. La función ICSeqCompressFrameStart usa el valor de este miembro para crear fotogramas clave.

lDataRate

Velocidad de datos, en kilobytes por segundo. ICCompressorChoose copia la velocidad de datos seleccionada del cuadro de diálogo a este miembro.

lQ

Configuración de calidad. Especifique un valor de calidad de 1 a 10 000 o especifique ICQUALITY_DEFAULT para usar la configuración de calidad predeterminada. También puede permitir que ICCompressorChoose establezca el valor de calidad seleccionado en el cuadro de diálogo. ICSeqCompressFrameStart usa el valor de este miembro como valor de calidad.

lKeyCount

Reservado; no usar.

lpState

Reservado; no usar.

cbState

Reservado; no usar.

Comentarios

Puede permitir que ICCompressorChoose rellene el contenido de esta estructura o puede hacerlo manualmente. Si rellena manualmente la estructura, debe proporcionar información para los siguientes miembros: cbSize, hic, lpbiOut, lKey y lQ. Además, debe establecer la marca ICMF_COMPVARS_VALID en el miembro dwFlags .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	vfw.h