DEBUG_REGISTER_DESCRIPTION Struktur (dbgeng.h)

Die DEBUG_REGISTER_DESCRIPTION Struktur wird von GetDescription- zurückgegeben, um das Register eines Prozessors zu beschreiben.

Syntax

typedef struct _DEBUG_REGISTER_DESCRIPTION {
  ULONG   Type;
  ULONG   Flags;
  ULONG   SubregMaster;
  ULONG   SubregLength;
  ULONG64 SubregMask;
  ULONG   SubregShift;
  ULONG   Reserved0;
} DEBUG_REGISTER_DESCRIPTION, *PDEBUG_REGISTER_DESCRIPTION;

Angehörige

Type

Der Typ des Werts, den dieses Register enthält. Die möglichen Werte sind identisch mit dem Feld Typ- in der DEBUG_VALUE-Struktur.

Flags

Ein Bitfeld mit Flags für das Register. Derzeit ist das einzige Bit, das festgelegt werden kann, DEBUG_REGISTER_SUB_REGISTER, was angibt, dass es sich bei diesem Register um eine Unterregisterdatei handelt.

SubregMaster

Der Index des Registers, dessen Register ein Unterregister ist. Dieses Feld wird nur verwendet, wenn das DEBUG_REGISTER_SUB_REGISTER Bit in Flagsfestgelegt ist; andernfalls wird sie auf Null festgelegt.

SubregLength

Die Größe dieses Unterregisters in Bits. Dieses Feld wird nur verwendet, wenn das DEBUG_REGISTER_SUB_REGISTER Bit in Flagsfestgelegt ist; andernfalls wird sie auf Null festgelegt.

SubregMask

Die Bitmaske, die das in Subreg Master angegebene Register in dieses Unterregister konvertiert. Dieses Feld wird nur verwendet, wenn das DEBUG_REGISTER_SUB_REGISTER Bit in Flagsfestgelegt ist; andernfalls wird sie auf Null festgelegt.

SubregShift

Die Bitverschiebung, die das in SubregMaster- angegebene Register in dieses Unterregister konvertiert. Dieses Feld wird nur verwendet, wenn das DEBUG_REGISTER_SUB_REGISTER Bit in Flagsfestgelegt ist; andernfalls wird sie auf Null festgelegt.

Reserved0

Reserviert für die Systemverwendung.

Bemerkungen

Wenn es sich bei diesem Register um ein Unterregister handelt, kann der Wert des vollständigen Registers in den Wert des Unterregisters umgewandelt werden, indem zuerst SubregShift Bits nach rechts verschoben und dann das Ergebnis mit SubregMask mithilfe des bitweisen AND-Operators kombiniert wird. Die Größe des Unterregisters (SubregLength) ist die Anzahl der Bits, die in SubregMaskfestgelegt werden.

Allgemeine Informationen zu Registern finden Sie unter Register.

Anforderungen