Función ICLocate (vfw.h)

La función ICLocate busca un compresor o descomprimor que puede controlar imágenes con los formatos especificados, o busca un controlador que pueda descomprimir una imagen con un formato especificado directamente al hardware.

Sintaxis

HIC VFWAPI ICLocate(
  DWORD              fccType,
  DWORD              fccHandler,
  LPBITMAPINFOHEADER lpbiIn,
  LPBITMAPINFOHEADER lpbiOut,
  WORD               wFlags
);

Parámetros

fccType

Código de cuatro caracteres que indica el tipo de compresor o descompresión que se va a abrir. En el caso de las secuencias de vídeo, el valor de este parámetro es "VIDC".

fccHandler

Controlador preferido del tipo especificado. Normalmente, el tipo de controlador se almacena en el encabezado de secuencia en un archivo AVI. Especifique NULL si la aplicación puede usar cualquier tipo de controlador o no conoce el tipo de controlador que se va a usar.

lpbiIn

Puntero a una estructura BITMAPINFOHEADER que define el formato de entrada. No se devuelve un asa de compresor a menos que admita este formato.

lpbiOut

Puntero a una estructura BITMAPINFOHEADER que define un formato descomprimido opcional. También puede especificar cero para usar el formato de salida predeterminado asociado al formato de entrada.

Si este parámetro es distinto de cero, no se devuelve un controlador de compresor a menos que pueda crear este formato de salida.

wFlags

Marcas que describen los criterios de búsqueda de un compresor o descomprimor. Se definen los siguientes valores:

Valor	Significado
ICMODE_COMPRESS	Busca un compresor que puede comprimir una imagen con un formato definido por lpbiIn al formato definido por lpbiOut.
ICMODE_DECOMPRESS	Busca un descomprimor que puede descomprimir una imagen con un formato definido por lpbiIn al formato definido por lpbiOut.
ICMODE_DRAW	Busca un descomprimor que puede descomprimir una imagen con un formato definido por lpbiIn y dibujarlo directamente en hardware.
ICMODE_FASTCOMPRESS	Tiene el mismo significado que ICMODE_COMPRESS excepto que el compresor se utiliza para una operación en tiempo real y destaca la velocidad sobre la calidad.
ICMODE_FASTDECOMPRESS	Tiene el mismo significado que ICMODE_DECOMPRESS excepto que el descomprimor se usa para una operación en tiempo real y enfatiza la velocidad con respecto a la calidad.

Valor devuelto

Devuelve un mango a un compresor o descomprimor si es correcto o cero de lo contrario.

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