check_stack

Instructs the compiler to turn off stack probes if off (or -) is specified, or to turn on stack probes if on (or +) is specified.

Syntax

#pragma check_stack([ {on | off}] )
#pragma check_stack{+ | -}

Remarks

If no argument is given, stack probes are treated according to the default. This pragma takes effect at the first function defined after the pragma is seen. Stack probes are neither a part of macros nor of functions that are generated inline.

If you don't give an argument for the check_stack pragma, stack checking reverts to the behavior specified on the command line. For more information, see Compiler Reference. The interaction of the #pragma check_stack and the /Gs option is summarized in the following table.

Using the check_stack Pragma

Syntax Compiled with

/Gs option?
Action
#pragma check_stack( ) or

#pragma check_stack
Yes Turns off stack checking for functions that follow
#pragma check_stack( ) or

#pragma check_stack
No Turns on stack checking for functions that follow
#pragma check_stack(on)

or #pragma check_stack +
Yes or No Turns on stack checking for functions that follow
#pragma check_stack(off)

or #pragma check_stack -
Yes or No Turns off stack checking for functions that follow

See also

Pragma Directives and the __Pragma Keyword