KUSER_SHARED_DATA-Struktur (ntddk.h)

Artikel
02/26/2024

In diesem Thema wird die KUSER_SHARED_DATA-Struktur beschrieben.

Syntax

typedef struct _KUSER_SHARED_DATA {
  ULONG                         TickCountLowDeprecated;
  ULONG                         TickCountMultiplier;
  KSYSTEM_TIME                  InterruptTime;
  KSYSTEM_TIME                  SystemTime;
  KSYSTEM_TIME                  TimeZoneBias;
  USHORT                        ImageNumberLow;
  USHORT                        ImageNumberHigh;
  WCHAR                         NtSystemRoot[260];
  ULONG                         MaxStackTraceDepth;
  ULONG                         CryptoExponent;
  ULONG                         TimeZoneId;
  ULONG                         LargePageMinimum;
  ULONG                         AitSamplingValue;
  ULONG                         AppCompatFlag;
  ULONGLONG                     RNGSeedVersion;
  ULONG                         GlobalValidationRunlevel;
  LONG                          TimeZoneBiasStamp;
  ULONG                         NtBuildNumber;
  NT_PRODUCT_TYPE               NtProductType;
  BOOLEAN                       ProductTypeIsValid;
  BOOLEAN                       Reserved0[1];
  USHORT                        NativeProcessorArchitecture;
  ULONG                         NtMajorVersion;
  ULONG                         NtMinorVersion;
  BOOLEAN                       ProcessorFeatures[PROCESSOR_FEATURE_MAX];
  ULONG                         Reserved1;
  ULONG                         Reserved3;
  ULONG                         TimeSlip;
  ALTERNATIVE_ARCHITECTURE_TYPE AlternativeArchitecture;
  ULONG                         BootId;
  LARGE_INTEGER                 SystemExpirationDate;
  ULONG                         SuiteMask;
  BOOLEAN                       KdDebuggerEnabled;
  union {
    UCHAR MitigationPolicies;
    struct {
      UCHAR NXSupportPolicy : 2;
      UCHAR SEHValidationPolicy : 2;
      UCHAR CurDirDevicesSkippedForDlls : 2;
      UCHAR Reserved : 2;
    };
  };
  USHORT                        CyclesPerYield;
  ULONG                         ActiveConsoleId;
  ULONG                         DismountCount;
  ULONG                         ComPlusPackage;
  ULONG                         LastSystemRITEventTickCount;
  ULONG                         NumberOfPhysicalPages;
  BOOLEAN                       SafeBootMode;
  union {
    UCHAR VirtualizationFlags;
    struct {
      UCHAR ArchStartedInEl2 : 1;
      UCHAR QcSlIsSupported : 1;
    };
  };
  UCHAR                         Reserved12[2];
  union {
    ULONG SharedDataFlags;
    struct {
      ULONG DbgErrorPortPresent : 1;
      ULONG DbgElevationEnabled : 1;
      ULONG DbgVirtEnabled : 1;
      ULONG DbgInstallerDetectEnabled : 1;
      ULONG DbgLkgEnabled : 1;
      ULONG DbgDynProcessorEnabled : 1;
      ULONG DbgConsoleBrokerEnabled : 1;
      ULONG DbgSecureBootEnabled : 1;
      ULONG DbgMultiSessionSku : 1;
      ULONG DbgMultiUsersInSessionSku : 1;
      ULONG DbgStateSeparationEnabled : 1;
      ULONG SpareBits : 21;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME2;
  ULONG                         DataFlagsPad[1];
  ULONGLONG                     TestRetInstruction;
  LONGLONG                      QpcFrequency;
  ULONG                         SystemCall;
  ULONG                         Reserved2;
  ULONGLONG                     SystemCallPad[2];
  union {
    KSYSTEM_TIME TickCount;
    ULONG64      TickCountQuad;
    struct {
      ULONG ReservedTickCountOverlay[3];
      ULONG TickCountPad[1];
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME3;
  ULONG                         Cookie;
  ULONG                         CookiePad[1];
  LONGLONG                      ConsoleSessionForegroundProcessId;
  ULONGLONG                     TimeUpdateLock;
  ULONGLONG                     BaselineSystemTimeQpc;
  ULONGLONG                     BaselineInterruptTimeQpc;
  ULONGLONG                     QpcSystemTimeIncrement;
  ULONGLONG                     QpcInterruptTimeIncrement;
  UCHAR                         QpcSystemTimeIncrementShift;
  UCHAR                         QpcInterruptTimeIncrementShift;
  USHORT                        UnparkedProcessorCount;
  ULONG                         EnclaveFeatureMask[4];
  ULONG                         TelemetryCoverageRound;
  USHORT                        UserModeGlobalLogger[16];
  ULONG                         ImageFileExecutionOptions;
  ULONG                         LangGenerationCount;
  ULONGLONG                     Reserved4;
  ULONGLONG                     InterruptTimeBias;
  ULONGLONG                     QpcBias;
  ULONG                         ActiveProcessorCount;
  UCHAR                         ActiveGroupCount;
  UCHAR                         Reserved9;
  union {
    USHORT QpcData;
    struct {
      UCHAR QpcBypassEnabled;
      UCHAR QpcShift;
    };
  };
  LARGE_INTEGER                 TimeZoneBiasEffectiveStart;
  LARGE_INTEGER                 TimeZoneBiasEffectiveEnd;
  XSTATE_CONFIGURATION          XState;
  KSYSTEM_TIME                  FeatureConfigurationChangeStamp;
  ULONG                         Spare;
  ULONG64                       UserPointerAuthMask;
} KUSER_SHARED_DATA, *PKUSER_SHARED_DATA;

Member

TickCountLowDeprecated

Aktuelle niedrige 32-Bit-Tick-Anzahl.

TickCountMultiplier

Multiplikator für die Tickanzahl.

InterruptTime

Aktuelle 64-Bit-Interruptzeit in 100ns-Einheiten.

SystemTime

Aktuelle 64-Bit-Systemzeit in 100ns-Einheiten.

TimeZoneBias

Aktuelle 64-Bit-Zeitzonenverzerrung.

ImageNumberLow

Niedrige magische Bildanzahl für das Hostsystem.

ImageNumberHigh

Hohe Bildmagiezahl für das Hostsystem.

NtSystemRoot[260]

Kopie des Systemstamms in Unicode. Auf dieses Feld muss über die RtlGetNtSystemRoot-API zugegriffen werden, um ein genaues Ergebnis zu erhalten.

MaxStackTraceDepth

Maximale Stapelablaufverfolgungstiefe, wenn die Ablaufverfolgung aktiviert ist.

CryptoExponent

Krypto-Exponentwert.

TimeZoneId

Zeitzonen-ID.

LargePageMinimum

Definiert das ULONG-MemberLargePageMinimum.

AitSamplingValue

Dieser Wert steuert die AIT-Samplingrate.

AppCompatFlag

Dieser Wert steuert die Switchbackverarbeitung.

RNGSeedVersion

Aktuelle Kernelstamm-RNG-Status-Seedversion.

GlobalValidationRunlevel

Dieser Wert steuert die Assertionsfehlerbehandlung.

TimeZoneBiasStamp

Definiert den LONG-MemberTimeZoneBiasStamp.

NtBuildNumber

Die shared collective build number undecodrated with C or F. GetVersionEx blendet die reelle Zahl aus.

NtProductType

Produkttyp. Auf dieses Feld muss über die RtlGetNtProductType-API zugegriffen werden, um ein genaues Ergebnis zu erhalten.

ProductTypeIsValid

Definiert das BOOLEAN-MemberProductTypeIsValid.

Reserved0[1]

Für die zukünftige Verwendung reserviert.

NativeProcessorArchitecture

Definiert das USHORT-MemberNativeProcessorArchitecture.

NtMajorVersion

Die NT-Hauptversion. Jeder Prozess sieht eine Version aus seinem PEB, aber wenn der Prozess mit einer geänderten Ansicht der Systemversion ausgeführt wird, wird dieses Feld verwendet, um die Version ordnungsgemäß zu identifizieren.

NtMinorVersion

Die NT-Nebenversion. Jeder Prozess sieht eine Version aus seinem PEB, aber wenn der Prozess mit einer geänderten Ansicht der Systemversion ausgeführt wird, wird dieses Feld verwendet, um die Version ordnungsgemäß zu identifizieren.

ProcessorFeatures[PROCESSOR_FEATURE_MAX]

Prozessorfeatures.

Reserved1

Für zukünftige Verwendung reserviert.

Reserved3

Für zukünftige Verwendung reserviert.

TimeSlip

Zeitabweichung während des Debuggers.

AlternativeArchitecture

Alternative Systemarchitektur. Beispiel: NEC PC98xx auf x86.

BootId

Startsequenz, die für jeden Startversuch vom Betriebssystemladeprogramm inkrementiert wird.

SystemExpirationDate

Wenn es sich bei dem System um eine Auswertungseinheit handelt, enthält das folgende Feld das Datum und die Uhrzeit des Ablaufs der Auswertungseinheit. Der Wert 0 gibt an, dass es keinen Ablauf gibt. Ein Wert ungleich 0 ist die absolute UTC-Zeit, zu der das System abläuft.

SuiteMask

Suite-Unterstützung. Auf dieses Feld muss über die RtlGetSuiteMask-API zugegriffen werden, um ein genaues Ergebnis zu erhalten.

KdDebuggerEnabled

TRUE, wenn ein Kerneldebugger verbunden/aktiviert ist.

MitigationPolicies

Entschärfungsrichtlinien.

NXSupportPolicy

Definiert das UCHAR-MemberNXSupportPolicy.

SEHValidationPolicy

Definiert das UCHAR-MemberSEHValidationPolicy.

CurDirDevicesSkippedForDlls

Definiert das UCHAR-MemberCurDirDevicesSkippedForDlls.

Reserved

Für die zukünftige Verwendung reserviert.

CyclesPerYield

Gemessene Dauer eines einzelnen Prozessorertrags in Zyklen. Dies wird von Sperrpaketen verwendet, um zu bestimmen, wie oft vor dem Blockieren auf eine Zustandsänderung gewartet werden soll.

ActiveConsoleId

Aktuelle Konsolensitzungs-ID. Auf Nicht-TS-Systemen immer null. Auf dieses Feld muss über die RtlGetActiveConsoleId-API zugegriffen werden, um ein genaues Ergebnis zu erhalten.

DismountCount

Erzwingen der Bereitstellung von Bereitstellungen führen dazu, dass Handles ungültig werden. Statt immer Testhandles wird eine fortlaufende Anzahl von Dismounts beibehalten, die Clients verwenden können, um zu ermitteln, ob sie Handles testen müssen.

ComPlusPackage

Dieses Feld gibt die status des 64-Bit-COM+-Pakets auf dem System an. Es gibt an, ob die COM+-Images (Intermediate Language, IL) die 64-Bit-COM+-Runtime oder die 32-Bit-COM+-Runtime verwenden müssen.

LastSystemRITEventTickCount

Anzahl der Zeit in Ticks für systemweite letzte Benutzereingaben über alle Terminalsitzungen hinweg. Bei der MP-Leistung wird sie nicht ständig aktualisiert (z. B. einmal pro Minute pro Sitzung). Es wird für die Leerlauferkennung verwendet.

NumberOfPhysicalPages

Anzahl der physischen Seiten im System. Dies kann sich dynamisch ändern, da physischer Arbeitsspeicher einem ausgeführten System hinzugefügt oder entfernt werden kann.

SafeBootMode

True, wenn das System im abgesicherten Startmodus gestartet wurde.

VirtualizationFlags

Virtualisierungsflags.

ArchStartedInEl2

Halten Sie dieses Bitfeld mit dem Bitfeld in arc.w synchron.

QcSlIsSupported

Halten Sie dieses Bitfeld mit dem Bitfeld in arc.w synchron.

Reserved12[2]

Für die zukünftige Verwendung reserviert.

DUMMYUNIONNAME2

Dies ist ein gepacktes Bitfeld, das verschiedene Flags zum Systemzustand enthält. Sie müssen mithilfe von verriegelten Vorgängen bearbeitet werden. Für ein genaues Ergebnis muss über die RtlIsMultiSessionSku-API auf DbgMultiSessionSku zugegriffen werden.

DUMMYUNIONNAME2.SharedDataFlags

Definiert das ULONG-MemberSharedDataFlags.

DUMMYUNIONNAME2.DUMMYSTRUCTNAME2

Definiert die DUMMYSTRUCTNAME2-Struktur .

DUMMYUNIONNAME2.DUMMYSTRUCTNAME2.DbgErrorPortPresent