IsProcessorFeaturePresent function (processthreadsapi.h)
Determines whether the specified processor feature is supported by the current computer.
Syntax
BOOL IsProcessorFeaturePresent(
[in] DWORD ProcessorFeature
);
Parameters
[in] ProcessorFeature
The processor feature to be tested. This parameter can be one of the following values.
Value | Meaning |
---|---|
|
The 64-bit load/store atomic instructions are available. |
|
The divide instructions are available. |
|
The external cache is available. |
|
The floating-point multiply-accumulate instruction is available. |
|
The VFP/Neon: 32 x 64bit register bank is present. This flag has the same meaning as PF_ARM_VFP_EXTENDED_REGISTERS. |
|
The 3D-Now instruction set is available. |
|
The processor channels are enabled. |
|
The atomic compare and exchange operation (cmpxchg) is available. |
|
The atomic compare and exchange 128-bit operation (cmpxchg16b) is available.
Windows Server 2003 and Windows XP/2000: This feature is not supported. |
|
The atomic compare 64 and exchange 128-bit operation (cmp8xchg16) is available.
Windows Server 2003 and Windows XP/2000: This feature is not supported. |
|
_fastfail() is available. |
|
Floating-point operations are emulated using a software emulator.
This function returns a nonzero value if floating-point operations are emulated; otherwise, it returns zero. |
|
On a Pentium, a floating-point precision error can occur in rare circumstances. |
|
The MMX instruction set is available. |
|
Data execution prevention is enabled. Windows XP/2000: This feature is not supported until Windows XP with SP2 and Windows Server 2003 with SP1. |
|
The processor is PAE-enabled. For more information, see
Physical Address Extension.
All x64 processors always return a nonzero value for this feature. |
|
The RDTSC instruction is available. |
|
RDFSBASE, RDGSBASE, WRFSBASE, and WRGSBASE instructions are available. |
|
Second Level Address Translation is supported by the hardware. |
|
The SSE3 instruction set is available.
Windows Server 2003 and Windows XP/2000: This feature is not supported. |
|
The SSSE3 instruction set is available. |
|
The SSE4_1 instruction set is available. |
|
The SSE4_2 instruction set is available. |
|
The AVX instruction set is available. |
|
The AVX2 instruction set is available. |
|
The AVX512F instruction set is available. |
|
Virtualization is enabled in the firmware and made available by the operating system. |
|
The SSE instruction set is available. |
|
The SSE2 instruction set is available.
Windows 2000: This feature is not supported. |
|
The processor implements the XSAVE and XRSTOR instructions.
Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP/2000: This feature is not supported until Windows 7 and Windows Server 2008 R2. |
|
This Arm processor implements the Arm v8 instructions set. |
|
This Arm processor implements the Arm v8 extra cryptographic instructions (for example, AES, SHA1 and SHA2). |
|
This Arm processor implements the Arm v8 extra CRC32 instructions. |
|
This Arm processor implements the Arm v8.1 atomic instructions (for example, CAS, SWP). |
|
This Arm processor implements the Arm v8.2 DP instructions (for example, SDOT, UDOT). This feature is optional in Arm v8.2 implementations and mandatory in Arm v8.4 implementations. |
|
This Arm processor implements the Arm v8.3 JSCVT instructions (for example, FJCVTZS). |
|
This Arm processor implements the Arm v8.3 LRCPC instructions (for example, LDAPR). Note that certain Arm v8.2 CPUs may optionally support the LRCPC instructions. |
Return value
If the feature is supported, the return value is a nonzero value.
If the feature is not supported, the return value is zero.
If the HAL does not support detection of the feature, whether or not the hardware supports the feature, the return value is also zero.
Remarks
Support for PF_SSSE3_INSTRUCTIONS_AVAILABLE
through PF_AVX512F_INSTRUCTIONS_AVAILABLE
were added in the Windows SDK (19041) and are supported by Windows 10, Version 2004 (May 2020 Update) or later.
Support for PF_ERMS_AVAILABLE
, PF_ARM_V82_DP_INSTRUCTIONS_AVAILABLE
, and PF_ARM_V83_JSCVT_INSTRUCTIONS_AVAILABLE
were added in the Windows SDK (20348) and are supported by Windows 11 and Windows Server 2022.
The define PF_ARM_V83_LRCPC_INSTRUCTIONS_AVAILABLE
was added in the Windows SDK (22621) and is supported by Windows 11, Version 22H2.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps | UWP apps] |
Minimum supported server | Windows 2000 Server [desktop apps | UWP apps] |
Target Platform | Windows |
Header | processthreadsapi.h (include Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |