VLCDecodeUTupleBlock

Decodes a block of VLC encoded data.

Syntax

IppStatus ippsVLCDecodeUTupleBlock_1u16s(Ipp8u** ppSrc, int* pSrcBitsOffset, Ipp16s* pDst, int dstLen, const IppsVLCDecodeUTupleSpec_32s* pVLCSpec);

Parameters

ppSrc	Double pointer to the source bitstream.
pSrcBitsOffset	Pointer to the input/output bit position.
pDst	Pointer to the destination buffer.
dstLen	Number of elements in the pDst.
pVLCSpec	Pointer to the VLC decoder specification structure.

Description

The function ippsVLCDecodeUTupleBlock is declared in the ippdc.h file. This function decodes dstLen VLC encoded elements in the source bitstream starting from the pSrcBitsOffset bit position. The function stores the result in the destination buffer pDst. After decoding the function shifts the source pointer by the number of successfully read and processed bytes. The function updates pSrcBitsOffset setting it to the actual bit position in the source buffer.

The function ippsVLCDecodeUTupleBlock uses the VLC table from the decoder specification structure pVLCSpec that must be initialized by the functions ippsVLCDecodeUTupleInitAlloc or ippsVLCDecodeUTupleInit beforehand.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error if one of the specified pointers is NULL.
ippStsVLCInputDataErr	Indicates an error if incorrect input is used. It can indicate that bitstream contains code that is not specified in the table.
ippStsBitOffsetErr	Indicates an error if value of the pSrcBitsOffset is less than 0 or greater than 7.
ippStsContextMatchErr	Indicates an error if the pVLCSpec structure is not initialized by the function ippsVLCDecodeUTupleInitAlloc or ippsVLCDecodeUTupleInit.