Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 10/31/2024
Public
Document Table of Contents

IIRIIRSetDlyLine

Sets the delay line contents in the IIRIIR filter state structure.

Syntax

IppStatus ippsIIRIIRSetDlyLine_32f(IppsIIRState_32f* pState, const Ipp32f* pDlyLine);

IppStatus ippsIIRIIRSetDlyLine64f_32f(IppsIIRState64f_32f* pState, const Ipp64f* pDlyLine);

IppStatus ippsIIRIIRSetDlyLine_64f(IppsIIRState_64f* pState, const Ipp64f* pDlyLine);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

pState

Pointer to the IIRIIR filter state structure.

pDlyLine

Pointer to the array holding the delay line values. The number of elements in the array is order. If the pointer is NULL, then the delay line values in the state structure are formed internally to minimize the start-up and ending transients. These values are obtained by matching the initial conditions to remove the DC offset at the beginning and the end of the input vector.

Description

This function copies the delay line values from pDlyLine and stores them into the pState structure . If the pointer is NULL, then the delay line values in the state structure are initialized to values that minimize the start-up and ending transients. These values are obtained by matching the initial conditions to remove the DC offset at the beginning and the end of the input vector.

The filter state must be initialized beforehand by the initialization function.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when the pState pointer is NULL.

ippStsContextMatchErr

Indicates an error when the state identifier is incorrect.