IIRSetTaps

Sets the taps in an IIR filter state.

Syntax

IppStatus ippsIIRSetTaps_32f(const Ipp32f* pTaps, IppsIIRState_32f* pState);

IppStatus ippsIIRSetTaps_32fc(const Ipp32fc* pTaps, IppsIIRState_32fc* pState);

IppStatus ippsIIRSetTaps_64f(const Ipp64f* pTaps, IppsIIRState_64f* pState);

IppStatus ippsIIRSetTaps_64fc(const Ipp64fc* pTaps, IppsIIRState_64fc* pState);

IppStatus ippsIIRSetTaps32s_16s(const Ipp32s* pTaps, IppsIIRState32s_16s* pState, int tapsFactor);

IppStatus ippsIIRSetTaps32s_16s32f(const Ipp32f* pTaps, IppsIIRState32s_16s* pState);

IppStatus ippsIIRSetTaps32sc_16sc(const Ipp32sc* pTaps, IppsIIRState32sc_16sc* pState, int tapsFactor);

IppStatus ippsIIRSetTaps32sc_16sc32fc(const Ipp32fc* pTaps, IppsIIRState32sc_16sc* pState);

IppStatus ippsIIRSetTaps32f_16s(const Ipp32f* pTaps, IppsIIRState32f_16s* pState);

IppStatus ippsIIRSetTaps32fc_16sc(const Ipp32fc* pTaps, IppsIIRState32fc_16sc* pState);

IppStatus ippsIIRSetTaps64f_16s(const Ipp64f* pTaps, IppsIIRState64f_16s* pState);

IppStatus ippsIIRSetTaps64f_32s(const Ipp64f* pTaps, IppsIIRState64f_32s* pState);

IppStatus ippsIIRSetTaps64f_32f(const Ipp64f* pTaps, IppsIIRState64f_32f* pState);

IppStatus ippsIIRSetTaps64fc_16sc(const Ipp64fc* pTaps, IppsIIRState64fc_16sc* pState);

IppStatus ippsIIRSetTaps64fc_32sc(const Ipp64fc* pTaps, IppsIIRState64fc_32sc* pState);

IppStatus ippsIIRSetTaps64fc_32fc(const Ipp64fc* pTaps, IppsIIRState64fc_32fc* pState);

Parameters

pTaps	Pointer to the array containing the tap values.
pState	Pointer to the IIR filter state structure.
tapsFactor	Scale factor for the taps of Ipp32s data type (for integer versions only).

Description

The function ippsIIRSetTaps is declared in the ipps.h file. This function sets new tap values in the previously initialized IIR filter state structure pState. New tap values must be specified in the array pTaps. To scale integer taps use the tapsFactor value.

The filter state must be initialized before calling the function ippsIIRSetTaps. The length of the array pTaps must be equal to the tapsLen parameter of the initialized filter state.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when one of the specified pointers is NULL.
ippStsDivByZeroErr	Indicates an error when A₀ is equal to 0 for an arbitrary IIR filter state, or A₀, A_n,0or B_n,0 is equal to 0 for a biquad IIR filter state.
ippStsContextMatchErr	Indicates an error when the state identifier is incorrect.