Funzione CreateCompressor (compressapi.h)

Articolo
02/24/2024

Genera un nuovo COMPRESSOR_HANDLE.

Sintassi

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

Parametri

[in] Algorithm

Tipo di algoritmo di compressione e modalità da utilizzare da questo compressore.

Questo parametro può avere uno dei valori seguenti, facoltativamente, combinato con il flag COMPRESS_RAW . Utilizzare un operatore "OR bit per bit" per includere COMPRESS_RAW e per creare un compressore in modalità blocco. Se COMPRESS_RAW non è incluso, l'API di compressione crea un compressore in modalità buffer. Per altre informazioni sulla selezione di un algoritmo di compressione e della modalità, vedere Uso dell'API di compressione.

Valore	Significato
COMPRESS_ALGORITHM_MSZIP 2	Algoritmo di compressione MSZIP
COMPRESS_ALGORITHM_XPRESS 3	Algoritmo di compressione XPRESS
COMPRESS_ALGORITHM_XPRESS_HUFF 4	Algoritmo di compressione XPRESS con codifica Huffman
COMPRESS_ALGORITHM_LZMS 5	Algoritmo di compressione LZMS

[in, optional] AllocationRoutines

Allocazione di memoria facoltativa e routine di deallocazione in una struttura COMPRESS_ALLOCATION_ROUTINES .

[out] CompressorHandle

Se la funzione ha esito positivo, l'handle per il compressore specificato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero. Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se l'algoritmo di compressione non riesce per qualche motivo interno, l'errore di GetLastError può essere ERROR_FUNCTION_FAILED. Se il sistema non trova alcun algoritmo di compressione corrispondente al nome e alla versione specificati, l'errore può essere ERROR_NOT_SUPPORTED.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	compressapi.h
Libreria	Cabinet.lib
DLL	Cabinet.dll

Vedi anche

COMPRESS_ALLOCATION_ROUTINES

Funzioni API di compressione

Condividi tramite