Visible to Intel only — GUID: GUID-1206E467-E6D2-444B-AAA2-71232FD2E164
Visible to Intel only — GUID: GUID-1206E467-E6D2-444B-AAA2-71232FD2E164
SetFlushToZero
Enables or disables flush-to-zero (FTZ) mode.
Syntax
IppStatus ippSetFlushToZero(int value, unsigned int* pUMask);
Include Files
ippcore.h
Parameters
value |
Switch to set or clear the corresponding bit of the MXCSR register.
|
pUMask |
Pointer to the current underflow exception mask; may be set to NULL. |
Description
This function enables FTZ mode for processors that support Intel® Streaming SIMD Extensions [xx] instructions. The FTZ mode controls the masked response to a SIMD floating-point underflow condition. Use this function to improve performance of applications where underflows are common and rounding the underflow result to zero is acceptable.
FTZ mode is possible only when the mask register is in a certain state. The ippSetFlushToZero function checks and changes this state if necessary. After disabling the FTZ mode, you can restore the initial mask register state. To do this, declare a variable of unsigned integer type in your application and point to it the parameter pUMask of the ippSetFlushToZero function. The initial state of mask register is saved in this location and can be restored later. If you do not need to restore the initial mask state, then the pointer pUMask may be set to NULL.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsCpuNotSupportedErr |
Indicates an error condition when the FTZ mode is not supported by the processor. |