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

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

TopKGetBufferSize

Computes the size of the buffer for the TopK function.

Syntax

IppStatus ippsTopKGetBufferSize(Ipp64s srcLen, Ipp64s dstLen, IppDataType dataType, IppTopKMode hint, Ipp64s* bufSize);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

srcLen

Number of elements in the source vector.

dstLen

Number of K values to be returned, the function returns min(K, dstLen) elements.

dataType

Data type of the vector.

hint

Parameter to choose the optimization that is most suitable for the srcLen+dstlen(K) combination, supported values: ippTopKAuto/ ippTopKDirect/ ippTopKRadix.

bufSize

Size of the required work buffer.

Description

This function computes the size of the work buffer required for the ippsTopK function.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when bufSize is NULL.

ippStsSizeErr

Indicates an error when at least one of the srcLen or dstLen values is less than, or equal to zero.

ippStsBadArgErr

Indicates an error when the hint value is not supported.

See Also