Freigeben über

struct UNWIND_CODE

  • Artikel

Das Entladecode-Array wird zum Aufzeichnen der Folge von Vorgängen im Prolog verwendet, die sich auf nicht veränderliche Register und RSP auswirken. Jedes Codeelement hat das folgende Format:

UBYTE

Offset im Prolog

UBYTE: 4

Entladeoperationscode

UBYTE: 4

Operationsinfo

Das Array wird in absteigender Reihenfolge des Offsets im Prolog sortiert.

  • Offset im Prolog
    Offset vom Anfang des Prologs vom Ende der Anweisung, die diese Operation ausführt, plus 1 (d. h. der Offset des Starts der nächsten Anweisung).

  • Entladeoperationscode
    Hinweis: Bestimmte Operationscodes erfordern einen Offset ohne Vorzeichen für einen Wert im lokalen Stapelrahmen. Dies ist ein Offset vom Anfang (der niedrigsten Adresse) der festen Stapelzuweisung. Wenn das Frameregisterfeld in UNWIND_INFO 0 (null) ist, ist dies ein Offset von RSP. Wenn das Frameregisterfeld einen Wert ungleich 0 (null) hat, ist dies der Offset vom Speicherort von RSP zum Zeitpunkt der Einrichtung von FP reg. Dies entspricht FP reg minus dem FP reg-Offset (16 * der skalierte Frameregisteroffset in UNWIND_INFO). Wenn ein FP reg verwendet wird, kann ein Entladecode mit einem Offset erst verwendet werden, nachdem im Prolog FP reg eingerichtet wurde.

    Bei allen Opcodes mit Ausnahme von UWOP_SAVE_XMM128 und UWOP_SAVE_XMM128_FAR ist der Offset immer ein Vielfaches von 8, da alle relevanten Stapelwerte auf 8-Byte-Grenzen gespeichert sind (der Stapel selbst ist stets in 16 Byte ausgerichtet). Bei Operationscodes mit kurzem Offset (weniger als 512 K) enthält der letzte USHORT in den Knoten für diesen Code den Offset geteilt durch 8. Bei Operationscodes mit langem Offset (512 K <= Offset < 4 GB) enthalten die letzten beiden USHORT-Knoten für diesen Code den Offset (im Little-Endian-Format).

    Bei den Opcodes UWOP_SAVE_XMM128 und UWOP_SAVE_XMM128_FAR ist der Offset immer ein Vielfaches von 16, da alle 128-Bit-XMM-Operationen in einem in 16 Byte ausgerichteten Speicher erfolgen müssen. Deshalb wird ein Skalierungsfaktor von 16 für UWOP_SAVE_XMM128 verwendet, der Offsets von weniger als 1 M erlaubt.

    Für den Entladeoperationscode gibt es folgende Möglichkeiten:

    UWOP_PUSH_NONVOL (0)1 Knoten

    Ein nicht veränderliches Ganzzahlregister wird verschoben und RSP um 8 dekrementiert. Die Operationsinfo ist die Anzahl der Register. Beachten Sie, dass aufgrund der Beschränkungen für Epiloge UWOP_PUSH_NONVOL-Entladecodes zuerst im Prolog und dementsprechend zuletzt im Entladecode-Array auftreten müssen. Diese relative Anordnung gilt mit Ausnahme von UWOP_PUSH_MACHFRAME für alle anderen Entladecodes.

    UWOP_ALLOC_LARGE (1)2 oder 3 Knoten

    Zuweisen eines großen Bereichs auf dem Stapel. Dies kann in zwei Formen erfolgen. Wenn die Operationsinfo gleich 0 (null) ist, wird die Größe der Zuweisung geteilt durch 8 im nächsten Slot aufgezeichnet, sodass eine Zuweisung bis zu 512 K – 8 möglich ist. Wenn die Operationsinfo 1 ist, wird die unskalierte Größe der Zuweisung im Little-Endian-Format in den nächsten beiden Slots aufgezeichnet, sodass Zuweisungen bis zu 4 GB – 8 möglich sind.

    UWOP_ALLOC_SMALL (2)1 Knoten

    Zuweisen eines kleinen Bereichs auf dem Stapel. Die Größe der Zuweisung ist das Operationsinfofeld * 8 + 8, sodass Zuweisungen von 8 bis 128 Byte möglich sind.

    Für den Entladecode für eine Stapelreservierung sollte immer eine so kurze Codierung wie möglich verwendet werden:

    Zuweisungsgröße

    Entladecode

    8 bis 128 Byte

    UWOP_ALLOC_SMALL

    136 bis 512 K - 8-Byte

    UWOP_ALLOC_LARGE, Operationsinfo = 0

    512 K bis 4 G - 8 Byte

    UWOP_ALLOC_LARGE, Operationsinfo = 1

    UWOP_SET_FPREG (3)1 Knoten

    Erstellen Sie das Framezeigerregister, indem Sie für das Register einen Offset vom aktuellen RSP angeben. Der Offset entspricht dem Frameregisteroffset-Feld (skaliert) in UNWIND_INFO * 16 mit möglichen Offsets von 0 bis 240. Die Verwendung eines Offsets erlaubt die Erstellung eines Framezeigers, der auf die Mitte der festen Stapelzuweisung verweist. Dies unterstützt eine höhere Codedichte, da mehr Zugriffe für die Verwendung kurzer Anweisungsformen möglich sind. Beachten Sie, dass das Operationsinfofeld reserviert ist und nicht verwendet werden sollte.

    UWOP_SAVE_NONVOL (4)2 Knoten

    Ein nicht veränderliches Ganzzahlregister wird auf dem Stapel mit einem MOV anstelle eines PUSH gespeichert. Dies wird hauptsächlich zum platzsparenden Verpacken verwendet, bei dem ein nicht veränderliches Register auf dem Stapel in einer zuvor zugewiesenen Position gespeichert wird. Die Operationsinfo ist die Anzahl der Register. Der um 8 skalierte Stapeloffset wird im nächsten Entladeoperationscode-Slot aufgezeichnet, wie im Hinweis oben beschrieben.

    UWOP_SAVE_NONVOL_FAR (5)3 Knoten

    Ein nicht veränderliches Ganzzahlregister wird auf dem Stapel mit langem Offset gespeichert, wobei ein MOV anstelle eines PUSH verwendet wird. Dies wird hauptsächlich zum platzsparenden Verpacken verwendet, bei dem ein nicht veränderliches Register auf dem Stapel in einer zuvor zugewiesenen Position gespeichert wird. Die Operationsinfo ist die Anzahl der Register. Der unskalierte Stapeloffset wird in den nächsten beiden Entladeoperationscode-Slots aufgezeichnet, wie im Hinweis oben beschrieben.

    UWOP_SAVE_XMM128 (8)2 Knoten

    Die gesamten 128 Bits eines nicht veränderlichen XMM-Registers werden auf dem Stapel gespeichert. Die Operationsinfo ist die Anzahl der Register. Der um 16 skalierte Stapeloffset wird im nächsten Slot aufgezeichnet.

    UWOP_SAVE_XMM128_FAR (9)3 Knoten

    Die gesamten 128 Bits eines nicht veränderlichen XMM-Registers werden auf dem Stapel mit einem langen Offset gespeichert. Die Operationsinfo ist die Anzahl der Register. Der unskalierte Stapeloffset wird in den nächsten beiden Slots aufgezeichnet.

    UWOP_PUSH_MACHFRAME (10)1 Knoten

    Verschieben eines Computerframes. Dies wird verwendet, um die Auswirkungen eines Hardware-Interrupts oder einer Ausnahme aufzuzeichnen. Dies kann in zwei Formen erfolgen. Wenn die Operationsinfo 0 (null) ist, wurde Folgendes auf dem Stapel abgelegt:

    RSP+32

    SS

    RSP+24

    Alter RSP

    RSP+16

    EFLAGS

    RSP+8

    CS

    RSP

    RIP

    Ist die Operationsinfo 1, wurde stattdessen Folgendes abgelegt:

    RSP+40

    SS

    RSP+32

    Alter RSP

    RSP+24

    EFLAGS

    RSP+16

    CS

    RSP+8

    RIP

    RSP

    Fehlercode

    Dieser Entladecode tritt stets in einem Platzhalter-Prolog auf, der nie tatsächlich ausgeführt wird, sondern vor dem wirklichen Einstiegspunkt einer Interruptroutine als Platzhalter für die Simulation der Verschiebung eines Computerframes dient. UWOP_PUSH_MACHFRAME zeichnet diese Simulation auf, die angibt, dass der Computer konzeptuell wie folgt vorgegangen ist:

    Auslesen der RIP-Rückgabeadresse oben im Stapel in Temp

    Ablegen von SS

    Ablegen des alten RSP

    Ablegen der EFLAGS

    Ablegen von CS

    Ablegen von Temp

    Ablegen des Fehlercodes (wenn op info 1 ist)

    Die simulierte UWOP_PUSH_MACHFRAME-Operation dekrementiert RSP um 40 (op info ist 0) oder um 48 (op info ist 1).

  • Operationsinfo
    Die Bedeutung dieser 4 Bits ist abhängig vom Operationscode. Für die Codierung eines Allzweckregisters (ganzzahlig) wird folgende Zuordnung verwendet:

    0

    RAX

    1

    RCX

    2

    RDX

    3

    RBX

    4

    RSP

    5

    RBP

    6

    RSI

    7

    RDI

    8 bis 15

    R8 to R15

Siehe auch

Referenz

Entladedaten für die Ausnahmebehandlung, Debuggerunterstützung