. RESTOREREG

Gera uma WOD_SAVE_NONVOL ou uma WOD_SAVE_NONVOL_FAR entrada de código de desenrolar para o registo e deslocamento especificados, usando o deslocamento do epílogo atual.

Sintaxe

.RESTOREREG regulador, deslocamento

Parâmetros

reg
O registo não volátil para restaurar.

Deslocamento
O deslocamento da pilha a partir do qual o registo é restaurado.

Remarks

.RESTOREREG só é válido no Unwind Versão 3. É o equivalente no epílogo de . SAVEREG.

O Microsoft Assembler (MASM) escolhe a codificação mais eficiente para um determinado deslocamento.

• .RESTOREREG só é permitido dentro de uma região de epílogo, entre . BEGINEPILOG e . FIM EPÍLOGO.
• Estas diretivas geram metadados de desmantelamento (.xdata e .pdata secções), mas não produzem código executável.
• No Unwind Versão 3, .RESTOREREG deve aparecer antes da instrução que carrega o registo a partir da pilha.
• Para garantir o acordo, envolve tanto as diretivas de desmantelamento como o código que devem desfazer numa macro.
• 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. Não são emitidos 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 020h
   sub rsp, 020h
   .savereg rbx, 0
   mov [rsp], rbx
   .savereg rsi, 8
   mov [rsp+8], rsi
.endprolog
   ; rest of function ...
   .beginepilog
   .restorereg rsi, 8
   mov rsi, [rsp+8]
   .restorereg rbx, 0
   mov rbx, [rsp]
   .freestack 020h
   add rsp, 020h
   .endepilog
   ret
Example1 ENDP
_text ENDS
END

Ver também

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