. RESTOREREG

WOD_SAVE_NONVOL Generuje wpis kodu lub WOD_SAVE_NONVOL_FAR odwijanego dla określonego rejestru i przesunięcia przy użyciu bieżącego przesunięcia epilogu.

Składnia

.RESTOREREG reg, przesunięcie

Parametry

reg
Rejestracja niewolna w celu przywrócenia.

offset
Przesunięcie stosu, z którego jest przywracany rejestr.

Remarks

Ważna

Niniejsza dyrektywa jest eksperymentalna i podlega zmianie. Włącz opcję Odwijaj wersję 3 przy użyciu polecenia ml64.exe /unwindv3.

.RESTOREREG jest prawidłowy tylko w wersji 3 odwijaj. Jest to epilog odpowiednik . SAVEREG.

Microsoft Assembler (MASM) wybiera najbardziej wydajne kodowanie dla danego przesunięcia.

• .RESTOREREG jest dozwolone tylko w regionie epilogu, między . BEGINEPILOG i . ENDEPILOG.
• Te dyrektywy generują metadane odwiju (.xdata i .pdata sekcje), ale nie tworzą kodu wykonywalnego.
• W systemie Unwind Version 3 musi pojawić się przed instrukcją, .RESTOREREG która ładuje rejestr ze stosu.
• Aby zapewnić umowę, zawijaj zarówno dyrektywy unwind, jak i kod, który mają na celu odwinięcie w makrze.
• W wersji 3 unwind dyrektywy epilogu są obowiązkowe dla epilogu odwijać generowanie kodu. Nie są emitowane żadne kody odwijaczające .BEGINEPILOG/.ENDEPILOG epilogu bez pary.

Note

W wersji 1 unwind dyrektywa pojawia się po odpowiedniej instrukcji. W wersji 3 unwind dyrektywa pojawia się przed instrukcją.

Przykład dla 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

Zobacz także

x64 Unwind, wersja 3 (eksperymentalna)
Odwołanie do dyrektyw
. SAVEREG
. BEGINEPILOG
Gramatyka MASM BNF