Intel® Integrated Performance Primitives Developer Reference

Developer Reference

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

GetCpuFeatures

Retrieves the processor features.

Syntax

IppStatus ippGetCpuFeatures(Ipp64u*
pFeaturesMask
, Ipp32u
pCpuidInfoRegs
[4]
);
Include Files
ippcore.h
Parameters
pFeaturesMask
Pointer to the features mask. Possible value is
ippCPUID_GETINFO_A
.
pCpuidInfoRegs
Pointer to the vector with four elements to store the data from the registers
eax
,
ebx
,
ecx
,
edx
 of the function
CPUID.1
.
Description
This function retrieves some of the CPU features returned by the function CPUID.1 and stores them consecutively in the mask
pFeaturesMask
. The following table lists the features stored in the mask.
If
pFeaturesMask
 does not have any input value, then the function retrieves the features in accordance with
eax=1
 and
ecx=0
. If
pFeaturesMask
 is set to
ippCPUID_GETINFO_A
, then the function retrieves the features in accordance with the input values of the registers
eax
 and
ecx
 that are specified in this case by the
pCpuidInfoRegs
[0] and
pCpuidInfoRegs
[2] respectively.
Mask Value
Bit Name
Feature
Mask Bit Number
0x00000001
ippCPUID_MMX
MMX™ technology
0
0x00000002
ippCPUID_SSE
Intel® Streaming SIMD Extensions
1
0x00000004
ippCPUID_SSE2
Intel® Streaming SIMD Extensions 2
2
0x00000008
ippCPUID_SSE3
Intel® Streaming SIMD Extensions 3
3
0x00000010
ippCPUID_SSSE3
Supplemental Streaming SIMD Extensions
4
0x00000020
ippCPUID_MOVBE
MOVBE instruction is supported
5
0x00000040
ippCPUID_SSE41
Intel® Streaming SIMD Extensions 4.1
6
0x00000080
ippCPUID_SSE42
Intel® Streaming SIMD Extensions 4.2
7
0x00000100
ippCPUID_AVX
The processor supports Intel® Advanced Vector Extensions (Intel® AVX) instruction set
8
0x00000200
ippAVX_ENABLEDBYOS
The operating system supports Intel® AVX
9
0x00000400
ippCPUID_AES
Advanced Encryption Standard (AES) instructions are supported
10
0x00000800
ippCPUID_CLMUL
PCLMULQDQ instruction is supported
11
0x00002000
ippCPUID_RDRAND
Read Random Number instructions are supported
13
0x00004000
ippCPUID_F16C
16-bit floating point conversion instructions are supported
14
0x00008000
ippCPUID_AVX2
Intel® Advanced Vector Extensions 2 (Intel® AVX2) instruction set is supported
15
0x00010000
ippCPUID_ADCOX
ADCX and ADOX instructions are supported
16
0x00020000
ippCPUID_RDSEED
Read Random SEED instruction is supported.
17
0x00040000
ippCPUID_PREFETCHW
PREFETCHW instruction is supported
18
0x00080000
ippCPUID_SHA
Intel® Secure Hash Algorithm Extensions (Intel® SHA Extensions) are supported
19
0x00100000
ippCPUID_AVX512F
Intel® Advanced Vector Extensions 512 (Intel® AVX-512) foundation instructions are supported
20
0x00200000
ippCPUID_AVX512CD
Intel® AVX-512 conflict detection instructions are supported
21
0x00400000
ippCPUID_AVX512ER
Intel® AVX-512 exponential and reciprocal instructions are supported
22
0x80000000
ippCPUID_KNC
Intel® Xeon Phi™ is supported
23
All features returned by the
CPUID.1
 function can be stored in the vector with four elements
pCpuidInfoRegs
 where each element contains data from one of the registers
eax
,
ebx
,
ecx
,
edx
 respectively. If these data are not required, the pointer
pCpuidInfoRegs
 must be set to
NULL
.
Intel
®
 Itanium
®
 processors are not supported.
Product and Performance Information
Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.
Notice revision #20201201
Return Values
ippStsNoErr
Indicates no error.
ippStsNullPtrErr
Indicates an error condition when the
pFeaturesMask
 pointer is
NULL
.
ippStsNotSupportedCpu
Indicates that the processor is not supported.

Product and Performance Information

1

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