VLCDecodeInitAlloc

Allocates memory and initializes the VLC decoder structure.

Syntax

ippsVLCDecodeInitAlloc_32s (const IppsVLCTable_32s* pInputTable, int inputTableSize, Ipp32s* pSubTablesSizes, int numSubTables, IppsVLCDecodeSpec_32s** ppVLCSpec);

Parameters

pInputTable	Pointer to the VLC table.
inputTableSize	Size of the VLC table.
pSubTablesSizes	Pointer to the sizes of the subtables.
numSubTables	Number of the subtables.
ppVLCSpec	Double pointer to the VLC decoder specification structure.

Description

The function ippsVLCDecodeInitAlloc is declared in the ippdc.h file. This function allocates memory and initializes the VLC decoder structure ppVLCSpec that is specified by the following parameters: the VLC table pInputTable of size inputTableSize, the number of internal subtables numSubTables and their sizes pSubTablesSizes. Size values for the subtables must be greater than 0. The sum of these values must be greater than or preferably equal to the maximum code length in the VLC table.

The VLC decoder specification structure is used by the functions ippsVLCDecodeBlock and iippsVLCDecodeOne.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error if one of the specified pointers is NULL.
ippStsMemAllocErr	Indicates an error if memory allocation fails.
ippStsVLCUsrTblCodeLengthErr	Indicates an error if the maximum code length in the input table exceeds 32; or if any size value for the subtables in pSubTablesSizes is less than 0; or if the sum of these values is less than the maximum code length in the input table.