Función ICCompressorChoose (vfw.h)

La función ICCompressorChoose muestra un cuadro de diálogo en el que un usuario puede seleccionar un compresor. Esta función puede mostrar todos los compresores registrados o enumerar únicamente los compresores que admiten un formato específico.

Sintaxis

BOOL VFWAPI ICCompressorChoose(
  HWND      hwnd,
  UINT      uiFlags,
  LPVOID    pvIn,
  LPVOID    lpData,
  PCOMPVARS pc,
  LPSTR     lpszTitle
);

Parámetros

hwnd

Identificador de una ventana primaria para el cuadro de diálogo.

uiFlags

Marcas aplicables. Se definen los valores siguientes.

Valor	Significado
ICMF_CHOOSE_ALLCOMPRESSORS	Todos los compresores deben aparecer en la lista de selección. Si no se especifica esta marca, solo los compresores que pueden controlar el formato de entrada aparecen en la lista de selección.
ICMF_CHOOSE_DATARATE	Muestra una casilla y una casilla de edición para especificar la velocidad de datos de la película.
ICMF_CHOOSE_KEYFRAME	Muestra una casilla y una casilla de edición para especificar la frecuencia de los fotogramas clave.
ICMF_CHOOSE_PREVIEW	Muestra un botón para expandir el cuadro de diálogo para incluir una ventana de vista previa. La ventana de vista previa muestra cómo aparecerán los fotogramas de la película cuando se comprima con la configuración actual.

pvIn

Formato de entrada de datos sin comprimir. Solo los compresores que admiten el formato de entrada de datos especificado se incluyen en la lista de compresores. Este parámetro es opcional.

lpData

Puntero a una interfaz de secuencia AVI que se va a usar en la ventana de vista previa. Debe especificar una secuencia de vídeo. Este parámetro es opcional.

pc

Puntero a una estructura COMPVARS . La información devuelta inicializa la estructura para su uso con otras funciones.

lpszTitle

Puntero a una cadena terminada en null que contiene un título para el cuadro de diálogo. Este parámetro es opcional.

Valor devuelto

Devuelve TRUE si el usuario elige un compresor y presiona Aceptar. Devuelve FALSE en caso de error o si el usuario presiona CANCEL.

Comentarios

Antes de usar esta función, establezca el miembro cbSize de la estructura COMPVARS en el tamaño de la estructura. Inicialice el resto de la estructura en ceros a menos que desee especificar algunos valores predeterminados válidos para el cuadro de diálogo. Si especifica valores predeterminados, establezca el miembro dwFlags en ICMF_COMPVARS_VALID e inicialice los demás miembros de la estructura. Para obtener más información sobre cómo inicializar la estructura, vea la función ICSeqCompressFrameStart y COMPVARS.

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]
Plataforma de destino	Windows
Encabezado	vfw.h
Library	Vfw32.lib
Archivo DLL	Msvfw32.dll

Consulte también

Funciones de compresión de vídeo

Administrador de compresión de vídeo