. POP2REG

Gera uma entrada de código de desmantelamento pop de dois registos para o par de registos especificado, usando o deslocamento atual no epílogo.

Syntax

. POP2REGregisto1, registo2

Parâmetros

registo1
O primeiro registo a estourar. Deve ser um registo de 64 bits de uso geral.

registo2
O segundo registo para rebentar. Deve ser um registo de 64 bits de uso geral.

O Registo1 e o Registo2 podem ser cada um dos seguintes:
RAX, RCX, RDX, RBX, RDI, RSI, RBP, R8, R9, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24, R25, R26, R27, R28, R29, R30, R31.

Remarks

Importante

Esta diretiva é experimental e está sujeita a alterações. Ativar Unwind Versão 3 com ml64.exe /unwindv3.

  • . POP2REG só é válido no Unwind Versão 3. É o equivalente no epílogo de . PUSH2REG.
  • . POP2REG 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.
  • Em Unwind Versão 3, . POP2REG deve aparecer antes da instrução que realmente implementa a ação a desenrolar.
  • 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.
  • Para garantir o acordo, envolve tanto as diretivas de desmantelamento como o código que devem desfazer numa macro.

Se o registo1 e o registo2 forem consecutivos e por ordem crescente, o MASM emite um WOD_PUSH_CONSECUTIVE_2 código de desmantelamento. Caso contrário, o MASM emite um WOD_PUSH2 código de desmantelamento.

Note

No Unwind Versão 1, a diretiva aparece após a instrução correspondente. Na Versão 3 de Desenrolar, a diretiva aparece antes da instrução.

Example

; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE
_text SEGMENT
Example1 PROC FRAME
   .push2reg rbx, rsi
   push2 rbx, rsi
   .push2reg r10, r11
   push2 r10, r11
.endprolog
   ; rest of function ...
   .beginepilog
   .pop2reg r10, r11
   pop2 r10, r11
   .pop2reg rbx, rsi
   pop2 rbx, rsi
   .endepilog
   ret
Example1 ENDP
_text ENDS
END

Ver também

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