DEBUG_REGISTER_DESCRIPTION-Struktur (dbgeng.h)

  • Artikel

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;

Member

Type

Der Werttyp, den dieses Register enthält. Die möglichen Werte sind mit denen für das Feld Typ in der DEBUG_VALUE-Struktur identisch.

Flags

Ein Bitfeld mit Flags für das Register. Das einzige Bit, das festgelegt werden kann, ist derzeit DEBUG_REGISTER_SUB_REGISTER, was angibt, dass es sich bei diesem Register um ein Unterregister handelt.

SubregMaster

Der Index des Registers, dessen Unterregister es ist. Dieses Feld wird nur verwendet, wenn das DEBUG_REGISTER_SUB_REGISTER Bit in Flags festgelegt ist. Andernfalls wird sie auf 0 festgelegt.

SubregLength

Die Größe dieses Unterregisters in Bits. Dieses Feld wird nur verwendet, wenn das DEBUG_REGISTER_SUB_REGISTER Bit in Flags festgelegt ist. Andernfalls wird sie auf 0 festgelegt.

SubregMask

Die Bitmaske, die das in SubregMaster angegebene Register in dieses Unterregister konvertiert. Dieses Feld wird nur verwendet, wenn das DEBUG_REGISTER_SUB_REGISTER Bit in Flags festgelegt ist. Andernfalls wird sie auf 0 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 Flags festgelegt ist. Andernfalls wird sie auf 0 festgelegt.

Reserved0

Ist für das System reserviert.

Hinweise

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 in SubregMask festgelegten Bits.

Allgemeine Informationen zu Registern finden Sie unter Register.

Anforderungen

Anforderung Wert
Header dbgeng.h (einschließlich DbgEng.h)