Funzione CreateDecompressor (compressapi.h)

Genera un nuovo DECOMPRESSOR_HANDLE.

Sintassi

BOOL CreateDecompressor(
  [in]           DWORD                         Algorithm,
  [in, optional] PCOMPRESS_ALLOCATION_ROUTINES AllocationRoutines,
  [out]          PDECOMPRESSOR_HANDLE          DecompressorHandle
);

Parametri

[in] Algorithm

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

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

[in, optional] AllocationRoutines

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

[out] DecompressorHandle

Se la funzione ha esito positivo, l'handle al decompressore 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

Vedi anche

COMPRESS_ALLOCATION_ROUTINES

Funzioni API di compressione