SubbandControllerDTUpdate

Updates the state of the DT controller and returns the step sizes.

Syntax

IppStatus ippsSubbandControllerDTUpdate_EC_16s(const Ipp32sc** ppSrcRinSubbandsHistory, const Ipp32sc* pSrcSinSubbands, const Ipp32sc* pSrcFilterErr, Ipp32s_EC_Sfs* pDstStepSize, int* pIsDT, int* pDisabledNLP, int startSubband, IppsSubbandControllerDTState_EC_16s* pState);

Parameters

pState	Pointer to state structure of the subband DT controller.
ppSrcRinSubbandsHistory	Pointer to an array of pointers to the most recent receive-in blocks. Size of the array is equal to numSegments specified in the function ippsSubbandControllerDTInit_EC.
pSrcSinSubbands	Pointer to subband representation of send-in signal frame (or NULL). Size of the array is equal to numSubbands specified in the function ippsSubbandControllerDTInit_EC.
pSrcFilterErr	Pointer to the input filter error vector. Vector length is equal to numSubbands specified in iippsSubbandControllerDTInit_EC.
pDstStepSize	Pointer to the vector of step sizes. Vector length is equal to numSubbands specified in ippsSubbandControllerDTInit_EC.
isDT	Pointer to the indicator that indicates the double-talk condition.
disabledNLP	Pointer to the indicator that indicates whether NLP is disable. If it equals 1 - NLP is disabled, if it equals 0 - NLP is not disabled.
startSubband	Indicates the number of subband the filtering starts from (0 ≤ startSubband < numSubbands).

Description

The functions ippsSubbandControllerDTUpdate_EC are declared in the ippsc.h file.

This function updates the internal state of the subband DT controller and return the step size values for further use in the coefficients' adaptation process.

The subband DT controller state structure pState must be initialized by the function ippsSubbandControllerDTInit_EC beforehand.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when one of the specified pointers is NULL.
ippStsBadArgErr	Indicates an error when startSubband is less than 0 or greater than or equal to the numSubbands.