Intel® Integrated Performance Primitives Developer Reference

Developer Reference

  • 2021
  • 01/25/2021
  • Public Content
Contents

ConvGetBufferSize

Computes the size of the work buffer for the
ippiConv
 function.

Syntax

IppStatus ippiConvGetBufferSize (IppiSize
src1Size
, IppiSize
src2Size
, IppDataType
dataType
, int
numChannels
, IppEnum
algType
, int*
pBufferSize
);
Include Files
ippi.h
Parameters
src1Size
,
src2Size
Size, in pixels, of the source images.
dataType
Data type for convolution. Possible values are
ipp32f
,
ipp16s
, or
ipp8u
.
numChannels
Number of image channels. Possible values are 1, 3, or 4.
algType
Bit-field mask for the algorithm type definition. Possible values are the results of composition of the
IppAlgType
 and
IppiROIShape
 values.
pBufferSize
Pointer to the size of the work buffer.
Description
The
ippiConvGetBufferSize
 function computes the size, in bytes, of the external work buffer needed for the function that performs two-dimensional convolution. The result is stored in the
pBufferSize
 parameter.
Return Values
ippStsNoErr
Indicates no error.
ippStsSizeErr
Indicates an error when the
src1Size
 or
src2Size
 is negative, or equal to zero.
ippStsNullChannelsErr
Indicates an error when the
numChannels
 value differs from 1, 3, or 4.
ippStsDataTypeErr
Indicates an error when the
dataType
 value differs from the
ipp32f
,
ipp16s
, or
ipp8u
.
ippStsAlgTypeErr
Indicates an error when:
  • the result of the bitwise AND operation between
    algType
     and
    ippAlgMask
     differs from the
    ippAlgAuto
    ,
    ippAlgDirect
    , or
    ippAlgFFT
     values;
  • the result of the bitwise AND operation between
    algType
     and
    ippiROIMask
     differs from the
    ippiROIFull
     or
    ippiROIValid
     values.
ippStsNullPtrErr
Indicates an error when the
pBufferSize
 is NULL.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.