Freigeben über

struct UNWIND_INFO

  • Artikel

Aktualisiert: November 2007

Die Entladedateninformationsstruktur wird zum Aufzeichnen der Auswirkungen einer Funktion auf den Stapelzeiger und des Speicherorts der nicht flüchtigen Register auf dem Stapel verwendet:

UBYTE: 3

Version

UBYTE: 5

Flags

UBYTE

Größe des Prologs

UBYTE

Anzahl der Entladecodes

UBYTE: 4

Rahmenregister

UBYTE: 4

Rahmenregisteroffset (skaliert)

USHORT * n

Entladecode-Array

variable

Kann die Form (1) oder (2) haben, wie unten angegeben

(1) Ausnahmehandler

ULONG

Adresse des Ausnahmehandlers

variable

Sprachspezifische Handlerdaten (optional)

(2) Verkettete Entladeinformationen

ULONG

Adresse des Funktionsanfangs

ULONG

Adresse des Funktionsendes

ULONG

Adresse der Entladeinformationen

Die UNWIND_INFO-Struktur muss im Arbeitsspeicher auf DWORD-Grenzen ausgerichtet sein. Die einzelnen Felder haben folgende Bedeutung:

  • Version
    Versionsnummer der Entladedaten, gegenwärtig 1.

  • Flags
    Drei Flags sind gegenwärtig definiert:

    UNW_FLAG_EHANDLER: Die Funktion hat einen Ausnahmehandler, der beim Suchen nach Funktionen aufgerufen werden sollte, die Ausnahmen überprüfen müssen.

    UNW_FLAG_UHANDLER: Die Funktion verfügt über einen Beendigungshandler, der beim Entladen einer Ausnahme aufgerufen werden sollte.

    UNW_FLAG_CHAININFO: Diese Entladeinfostruktur ist nicht die primäre für die Prozedur. Vielmehr handelt es sich beim verketteten Entladeinformationseintrag um den Inhalt eines vorhergehenden RUNTIME_FUNCTION-Eintrags. Eine Erklärung verketteter Entladeinformationsstrukturen finden Sie im folgenden Text. Wenn dieses Flag festgelegt ist, müssen die Flags UNW_FLAG_EHANDLER und UNW_FLAG_UHANDLER gelöscht werden. Außerdem müssen das Rahmenregisterfeld und das feste Stapelzuweisungsfeld dieselben Werte haben wie in den primären Entladeinformationen.

  • Größe des Prologs
    Länge des Funktionsprologs in Byte.

  • Anzahl der Entladecodes
    Dies ist die Anzahl der Slots im Entladecode-Array. Beachten Sie, dass einige Entladecodes (z. B. UWOP_SAVE_NONVOL) mehr als einen Slot im Array einnehmen.

  • Rahmenregister
    Bei einem Wert ungleich 0 (null) verwendet die Funktion einen Framezeiger, und dieses Feld gibt die Anzahl der nicht flüchtigen Register an, die als Framezeiger verwendet werden. Dieselbe Codierung wird für das Operationsinfofeld der UNWIND_CODE-Knoten verwendet.

  • Rahmenregisteroffset (skaliert)
    Wenn das Rahmenregisterfeld einen Wert ungleich 0 (null) hat, ist dieser Wert der skalierte Offset von RSP, der für FP reg übernommen wird, wenn es eingerichtet ist. Der tatsächliche Wert von FP reg ist RSP + 16 * diese Zahl, sodass Offsets von 0 bis 240 möglich sind. Dadurch kann FP reg bei dynamischen Stapelrahmen auf die Mitte der lokalen Stapelzuweisung verweisen, um eine höhere Codedichte durch kürzere Anweisungen zu erzielen (es können mehr Anweisungen den signierten 8-Bit-Offset verwenden).

  • Entladecode-Array
    Dies ist ein Array von Elementen, das die Auswirkungen des Prologs auf die nicht flüchtigen Register und RSP angibt. Informationen zu den Bedeutungen der einzelnen Elemente finden Sie im Abschnitt zu UNWIND_CODE. Aus Ausrichtungsgründen hat dieses Array stets eine gerade Anzahl von Einträgen, wobei der letzte Eintrag potenziell nicht verwendet wird (in diesem Fall ist das Array um einen Eintrag länger als durch den Zähler im Entladecodefeld angegeben).

  • Adresse des Ausnahmehandlers
    Hierbei handelt es sich um einen bildbezogenen Zeiger auf die sprachspezifische Ausnahme oder den Beendigungshandler der Funktion (wenn das Flag UNW_FLAG_CHAININFO nicht festgelegt und eines der Flags UNW_FLAG_EHANDLER oder UNW_FLAG_UHANDLER festgelegt ist).

  • Sprachspezifische Handlerdaten
    Dies sind die sprachspezifischen Ausnahmehandlerdaten der Funktion. Das Format dieser Daten ist nicht festgelegt und wird vollständig durch den verwendeten sprachspezifischen Ausnahmehandler bestimmt.

  • Verkettete Entladeinformationen
    Wenn das UNW_FLAG_CHAININFO-Flag festgelegt ist, endet die UNWIND_INFO-Struktur mit drei UWORDs. Diese UWORDs stellen die RUNTIME_FUNCTION-Informationen für die Funktion des verketteten Entladevorgangs dar.

Siehe auch

Referenz

Entladedaten für die Ausnahmebehandlung, Debuggerunterstützung