Compartilhar via


Função ICCompressorChoose (vfw.h)

A função ICCompressorChoose exibe uma caixa de diálogo na qual um usuário pode selecionar um compressor. Essa função pode exibir todos os compressores registrados ou listar apenas os compressores que dão suporte a um formato específico.

Sintaxe

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

Parâmetros

hwnd

Manipule para uma janela pai da caixa de diálogo.

uiFlags

Sinalizadores aplicáveis. Os valores a seguir são definidos.

Valor Significado
ICMF_CHOOSE_ALLCOMPRESSORS Todos os compressores devem aparecer na lista de seleção. Se esse sinalizador não for especificado, somente os compressores que podem manipular o formato de entrada aparecerão na lista de seleção.
ICMF_CHOOSE_DATARATE Exibe uma caixa de marcar e uma caixa de edição para inserir a taxa de dados do filme.
ICMF_CHOOSE_KEYFRAME Exibe uma caixa de marcar e uma caixa de edição para inserir a frequência dos quadros-chave.
ICMF_CHOOSE_PREVIEW Exibe um botão para expandir a caixa de diálogo para incluir uma janela de visualização. A janela de visualização mostra como os quadros do filme serão exibidos quando compactados com as configurações atuais.

pvIn

Formato de entrada de dados descompactado. Somente os compressores que dão suporte ao formato de entrada de dados especificado estão incluídos na lista de compressores. Esse parâmetro é opcional.

lpData

Ponteiro para uma interface de fluxo AVI a ser usada na janela de visualização. Você deve especificar um fluxo de vídeo. Esse parâmetro é opcional.

pc

Ponteiro para uma estrutura COMPVARS . As informações retornadas inicializam a estrutura para uso com outras funções.

lpszTitle

Ponteiro para uma cadeia de caracteres terminada em nulo que contém um título para a caixa de diálogo. Esse parâmetro é opcional.

Retornar valor

Retornará TRUE se o usuário escolher um compressor e pressionar OK. Retorna FALSE em caso de erro ou se o usuário pressionar CANCEL.

Comentários

Antes de usar essa função, defina o membro cbSize da estrutura COMPVARS para o tamanho da estrutura. Inicialize o restante da estrutura como zeros, a menos que você queira especificar alguns padrões válidos para a caixa de diálogo. Se especificar padrões, defina o membro dwFlags como ICMF_COMPVARS_VALID e inicialize os outros membros da estrutura. Para obter mais informações sobre como inicializar a estrutura, consulte a função ICSeqCompressFrameStart e COMPVARS.

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