Função CreateCompressor (compressapi.h)

Gera um novo COMPRESSOR_HANDLE.

Sintaxe

BOOL CreateCompressor(
  [in]           DWORD                         Algorithm,
  [in, optional] PCOMPRESS_ALLOCATION_ROUTINES AllocationRoutines,
  [out]          PCOMPRESSOR_HANDLE            CompressorHandle
);

Parâmetros

[in] Algorithm

O tipo de algoritmo de compactação e o modo a ser usado por esse compressor.

Esse parâmetro pode ter um dos seguintes valores, opcionalmente, combinados com o sinalizador COMPRESS_RAW . Use um operador OR "bit a bit" para incluir COMPRESS_RAW e criar um compressor de modo de bloco. Se COMPRESS_RAW não estiver incluído, a API de Compactação criará um compressor de modo buffer. Para obter mais informações sobre como selecionar um algoritmo e modo de compactação, consulte Usando a API de Compactação.

[in, optional] AllocationRoutines

Rotinas opcionais de alocação e desalocação de memória em uma estrutura COMPRESS_ALLOCATION_ROUTINES .

[out] CompressorHandle

Se a função for bem-sucedida, o identificador para o compressor especificado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero. Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se o algoritmo de compactação falhar por algum motivo interno, o erro de GetLastError poderá ser ERROR_FUNCTION_FAILED. Se o sistema não encontrar nenhum algoritmo de compactação que corresponda ao nome e à versão especificados, o erro poderá ser ERROR_NOT_SUPPORTED.

Requisitos

Confira também

COMPRESS_ALLOCATION_ROUTINES

Funções de API de Compactação