Função ICLocate (vfw.h)

Artigo
08/27/2023

A função ICLocate localiza um compressor ou descompactador que pode manipular imagens com os formatos especificados ou localiza um driver que pode descompactar uma imagem com um formato especificado diretamente no hardware.

Sintaxe

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

Parâmetros

fccType

Código de quatro caracteres que indica o tipo de compressor ou descompactador a ser aberto. Para fluxos de vídeo, o valor desse parâmetro é 'VIDC'.

fccHandler

Manipulador preferencial do tipo especificado. Normalmente, o tipo de manipulador é armazenado no cabeçalho do fluxo em um arquivo AVI. Especifique NULL se o aplicativo puder usar qualquer tipo de manipulador ou não souber o tipo de manipulador a ser usado.

lpbiIn

Ponteiro para uma estrutura BITMAPINFOHEADER definindo o formato de entrada. Um identificador de compressor não é retornado, a menos que dê suporte a esse formato.

lpbiOut

Ponteiro para uma estrutura BITMAPINFOHEADER definindo um formato descompactado opcional. Você também pode especificar zero para usar o formato de saída padrão associado ao formato de entrada.

Se esse parâmetro não for zero, um identificador de compressor não será retornado, a menos que possa criar esse formato de saída.

wFlags

Sinalizadores que descrevem os critérios de pesquisa para um compressor ou descompactador. Os seguintes valores são definidos:

Valor	Significado
ICMODE_COMPRESS	Localiza um compressor que pode compactar uma imagem com um formato definido por lpbiIn no formato definido por lpbiOut.
ICMODE_DECOMPRESS	Localiza um descompactador que pode descompactar uma imagem com um formato definido por lpbiIn no formato definido por lpbiOut.
ICMODE_DRAW	Localiza um descompactador que pode descompactar uma imagem com um formato definido por lpbiIn e desenhá-la diretamente para o hardware.
ICMODE_FASTCOMPRESS	Tem o mesmo significado que ICMODE_COMPRESS , exceto que o compressor é usado para uma operação em tempo real e enfatiza a velocidade sobre a qualidade.
ICMODE_FASTDECOMPRESS	Tem o mesmo significado que ICMODE_DECOMPRESS , exceto que o descompactador é usado para uma operação em tempo real e enfatiza a velocidade sobre a qualidade.

Retornar valor

Retorna um identificador para um compressor ou descompactador se tiver êxito ou zero caso contrário.

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]
Plataforma de Destino	Windows
Cabeçalho	vfw.h
Biblioteca	Vfw32.lib
DLL	Msvfw32.dll

Confira também

Funções de compactação de vídeo

Gerenciador de Compactação de Vídeo

Compartilhar via