SHASM Function-Definition Directives

To support the requirements of C++ and structured exception handling as well as provision of stack traces in the debugger, object files must contain information regarding where functions begin and end and what part of each function is devoted to setting up the function's stack frame. The following table shows SH assembler directives that define functions.

Directive Syntax Description
.ENTRY
<symbol>[:] .ENTRY
Marks beginning of a function.
.BIGENTRY
<symbol>[:] .BIGENTRY
Marks beginning of a function.
.ENDF
.ENDF
Marks end of a function.
.PROLOG
.PROLOG
Marks end of a function's prolog code. The function prolog is the code at the beginning of the function that sets up the function stack frame. The .PROLOG directive should appear between the last line of prolog code and the first line of non-prolog code for the function.
.PDATA
.PDATA <handler address>
[,<handler data>]
Specifies language-specific exception-handling information for current function. The .PDATA directive must appear before the .ENTRY or .BIGENTRY section to which it applies.

See Also

SHx Series Assembler Directives | SHASM Section and Location Directives | SHASM Symbol Handling Directives | SHASM Data and Data Area Directives | SHASM Debug Information Directives | SHASM Listing Directives | SHASM Miscellaneous Directives | SHASM Conditional Assembly Directives | SHASM Macro Directives

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.