. FREESTACK

Gera uma entrada de código de WOD_ALLOC_SMALL, WOD_ALLOC_LARGE ou WOD_ALLOC_HUGE de desenrolar com o tamanho especificado para o deslocamento atual no epílogo.

Sintaxe

. Tamanho do FREESTACK

Parâmetros

tamanho
O número de bytes a desalocar da pilha. Deve ser um múltiplo de 8.

Remarks

• Podes usar . FREESTACK apenas no Unwind Versão 3. É o equivalente no epílogo de . ALLOCSTACK.
• Podes usar . FREESTACK apenas dentro de uma região de epílogo, entre . BEGINEPILOG e . FIM EPÍLOGO.
• Em Unwind Versão 3, . O FREESTACK deve aparecer antes da add rsp, N instrução que implementa a deslocação da pilha.
• Para garantir o acordo, envolve tanto as diretivas de desmantelamento como o código que devem desfazer numa macro.
• Estas diretivas geram metadados de desmantelamento (.xdata e .pdata secções), mas não produzem código executável.
• O Microsoft Assembler (MASM) escolhe a codificação mais eficiente para um determinado tamanho.

O MASM emite um de três códigos de desmantelamento, dependendo do tamanho:

Na Versão 3 do Unwind, as diretivas de epílogo são obrigatórias para a geração do código de desmantelamento do epílogo. O assembler não emite códigos de desmantelamento do epílogo sem um .BEGINEPILOG/.ENDEPILOG par.

Exemplo para unwindv3

; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE
_text SEGMENT
Example1 PROC FRAME
   .allocstack 16
   sub rsp, 16
.endprolog
   ; function body
   .beginepilog
   .freestack 16
   add rsp, 16
   .endepilog
   ret
Example1 ENDP
_text ENDS
END

Ver também

x64 Unwind Versão 3 (experimental)
Referência de Diretivas
. ALLOCSTACK
. BEGINEPILOG
MASM BNF Gramática