KUSER_SHARED_DATA構造体 (ntddk.h)

[アーティクル]
02/07/2025

このトピックでは、KUSER_SHARED_DATA 構造について説明します。

構文

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                     FullNumberOfPhysicalPages;
  ULONGLONG                     SystemCallPad[1];
  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 QpcReserved;
    };
  };
  LARGE_INTEGER                 TimeZoneBiasEffectiveStart;
  LARGE_INTEGER                 TimeZoneBiasEffectiveEnd;
  XSTATE_CONFIGURATION          XState;
  KSYSTEM_TIME                  FeatureConfigurationChangeStamp;
  ULONG                         Spare;
  ULONG64                       UserPointerAuthMask;
  XSTATE_CONFIGURATION          XStateArm64;
  ULONG                         Reserved10[210];
} KUSER_SHARED_DATA, *PKUSER_SHARED_DATA;

メンバーズ

TickCountLowDeprecated

現在の低い 32 ビットのティック数。

TickCountMultiplier

ティック数乗数。

InterruptTime

現在の 64 ビット割り込み時間 (100ns 単位)。

SystemTime

現在の 64 ビットシステム時間 (100ns 単位)。

TimeZoneBias

現在の 64 ビットタイムゾーンバイアス。

ImageNumberLow

ホストシステムの画像マジック番号が低い。

ImageNumberHigh

ホストシステムの高いイメージマジック番号。

NtSystemRoot[260]

Unicode でのシステムルートのコピー。このフィールドは、正確な結果を得 RtlGetNtSystemRoot API を介してアクセスする必要があります。

MaxStackTraceDepth

トレースが有効な場合のスタックトレースの最大深度。

CryptoExponent

暗号指数値。

TimeZoneId

タイムゾーン ID。

LargePageMinimum

LargePageMinimum ULONG メンバー定義します。

AitSamplingValue

この値は、AIT サンプリングレートを制御します。

AppCompatFlag

この値は、スイッチバック処理を制御します。

RNGSeedVersion

現在のカーネルルート RNG 状態シードバージョン。

GlobalValidationRunlevel

この値は、アサーションエラー処理を制御します。

TimeZoneBiasStamp

TimeZoneBiasStamp LONG メンバーを定義します。

NtBuildNumber

C または F でアンコーディングされた共有集合ビルド番号 GetVersionEx は実数を非表示にします。

NtProductType

製品の種類。このフィールドは、正確な結果を得 RtlGetNtProductType API を介してアクセスする必要があります。

ProductTypeIsValid

ProductTypeIsValid の BOOLEAN メンバー定義します。

Reserved0[1]

将来の使用のために予約されています。

NativeProcessorArchitecture

NativeProcessorArchitecture USHORT メンバー定義します。

NtMajorVersion

NT メジャーバージョン。各プロセスには PEB のバージョンが表示されますが、プロセスがシステムバージョンの変更されたビューで実行されている場合は、このフィールドを使用してバージョンが正しく識別されます。

NtMinorVersion

NT マイナーバージョン。各プロセスには PEB のバージョンが表示されますが、プロセスがシステムバージョンの変更されたビューで実行されている場合は、このフィールドを使用してバージョンが正しく識別されます。

ProcessorFeatures[PROCESSOR_FEATURE_MAX]

プロセッサ機能。

Reserved1

将来の使用のために予約されています。

Reserved3

将来の使用のために予約されています。

TimeSlip

デバッガー中のタイムスリッページ。

AlternativeArchitecture

代替システムアーキテクチャ。たとえば、x86 の NEC PC98xx などです。

BootId

OS ローダーによるブート試行ごとにインクリメントされるブートシーケンス。

SystemExpirationDate

システムが評価単位の場合、次のフィールドには、評価単位の有効期限が切れる日時が含まれます。値 0 は、有効期限がないことを示します。 0 以外の値は、システムの有効期限が切れる UTC 絶対時刻です。

SuiteMask

スイートのサポート。正確な結果を得られるには、RtlGetSuiteMask API を使用してこのフィールドにアクセスする必要があります。

KdDebuggerEnabled

カーネルデバッガーが接続または有効になっている場合は TRUE。

MitigationPolicies

軽減ポリシー。

NXSupportPolicy

NXSupportPolicy UCHAR メンバーを定義します。

SEHValidationPolicy

SEHValidationPolicy UCHAR メンバー定義します。

CurDirDevicesSkippedForDlls

CurDirDevicesSkippedForDlls UCHAR メンバーを定義します。

Reserved

将来の使用のために予約されています。

CyclesPerYield

1 つのプロセッサの利回りの測定期間 (サイクル単位)。これは、ブロックする前に状態の変化を待機してスピンする回数を決定するために、ロックパッケージによって使用されます。

ActiveConsoleId

現在のコンソールセッション ID。TS 以外のシステムでは常にゼロ。このフィールドは、正確な結果を得るための RtlGetActiveConsoleId API を介してアクセスする必要があります。

DismountCount

強制的にマウントを解除すると、ハンドルが無効になります。常にプローブハンドルではなく、シリアル番号のマウント解除が維持され、クライアントはハンドルをプローブする必要があるかどうかを確認できます。

ComPlusPackage

このフィールドは、システム上の 64 ビット COM+ パッケージの状態を示します。中間言語 (IL) COM+ イメージで 64 ビット COM+ ランタイムと 32 ビット COM+ ランタイムのどちらを使用する必要があるかを示します。

LastSystemRITEventTickCount

すべてのターミナルセッションでのシステム全体の最後のユーザー入力の時間 (ティック数)。 MP パフォーマンスの場合、常に更新されるわけではありません (たとえば、セッションごとに 1 分に 1 回)。アイドル状態の検出に使用されます。

NumberOfPhysicalPages

システム内の物理ページの数。これは、物理メモリを実行中のシステムに追加または削除できるため、動的に変更される可能性があります。

SafeBootMode

システムがセーフブートモードで起動された場合は True。

VirtualizationFlags

仮想化フラグ。

ArchStartedInEl2

このビットフィールドは arc.w のビットフィールドと同期したままにしておきます。

QcSlIsSupported

このビットフィールドは arc.w のビットフィールドと同期したままにしておきます。

Reserved12[2]

将来の使用のために予約されています。

DUMMYUNIONNAME2

これは、システム状態に関するさまざまなフラグを含むパックされたビットフィールドです。これらは、インターロックされた操作を使用して操作する必要があります。 DbgMultiSessionSku は、正確な結果を得るための RtlIsMultiSessionSku API を介してアクセスする必要があります。

DUMMYUNIONNAME2.SharedDataFlags

SharedDataFlags ULONG メンバー定義します。

DUMMYUNIONNAME2.DUMMYSTRUCTNAME2

DUMMYSTRUCTNAME2 構造体を定義します。

DUMMYUNIONNAME2.DUMMYSTRUCTNAME2.DbgErrorPortPresent