KUSER_SHARED_DATA 구조체(ntddk.h)

아티클
08/07/2023

이 항목에서는 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]

유니코드의 시스템 루트 복사본입니다. 정확한 결과를 위해서는 RtlGetNtSystemRoot API를 통해 이 필드에 액세스해야 합니다.

MaxStackTraceDepth

추적을 사용하도록 설정한 경우 최대 스택 추적 깊이입니다.

CryptoExponent

암호화 지수 값입니다.

TimeZoneId

표준 시간대 ID입니다.

LargePageMinimum

ULONG 멤버 LargePageMinimum을 정의합니다.

AitSamplingValue

이 값은 AIT 샘플링 속도를 제어합니다.

AppCompatFlag

이 값은 스위치백 처리를 제어합니다.

RNGSeedVersion

현재 커널 루트 RNG 상태 시드 버전입니다.

GlobalValidationRunlevel

이 값은 어설션 실패 처리를 제어합니다.

TimeZoneBiasStamp

LONG 멤버 TimeZoneBiasStamp를 정의합니다.

NtBuildNumber

C 또는 F로 구분되지 않은 공유 집합 빌드 번호입니다. GetVersionEx 는 실제 번호를 숨깁니다.

NtProductType

제품 유형입니다. 정확한 결과를 위해서는 RtlGetNtProductType API를 통해 이 필드에 액세스해야 합니다.

ProductTypeIsValid

BOOLEAN 멤버 ProductTypeIsValid를 정의합니다.

Reserved0[1]

다음에 사용하도록 예약됩니다.

NativeProcessorArchitecture

USHORT 멤버 NativeProcessorArchitecture를 정의합니다.

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

UCHAR 멤버 NXSupportPolicy를 정의합니다.

SEHValidationPolicy

UCHAR 멤버 SEHValidationPolicy를 정의합니다.

CurDirDevicesSkippedForDlls

UCHAR 멤버 CurDirDevicesSkippedForDlls를 정의합니다.

Reserved

다음에 사용하도록 예약됩니다.

CyclesPerYield

단일 프로세서 수율의 측정된 기간(주기)입니다. 이는 잠금 패키지에서 차단하기 전에 상태 변경을 기다리는 스핀 횟수를 결정하는 데 사용됩니다.

ActiveConsoleId

현재 콘솔 세션 ID입니다. 비 TS 시스템에서는 항상 0입니다. 정확한 결과를 위해서는 RtlGetActiveConsoleId API를 통해 이 필드에 액세스해야 합니다.

DismountCount

강제 분리로 인해 핸들이 유효하지 않습니다. 항상 핸들을 프로브하는 대신 클라이언트가 핸들을 프로브해야 하는지 확인하는 데 사용할 수 있는 일련 번호의 분리가 유지 관리됩니다.

ComPlusPackage

이 필드는 시스템에서 64비트 COM+ 패키지의 상태 나타냅니다. IL(중간 언어) COM+ 이미지가 64비트 COM+ 런타임 또는 32비트 COM+ 런타임을 사용해야 하는지 여부를 나타냅니다.

LastSystemRITEventTickCount

모든 터미널 세션에서 시스템 전체의 마지막 사용자 입력에 대한 틱 시간 수입니다. MP 성능의 경우 항상 업데이트되지는 않습니다(예: 세션당 1분마다 한 번). 유휴 검색에 사용됩니다.

NumberOfPhysicalPages

시스템의 실제 페이지 수입니다. 이는 실행 중인 시스템에서 실제 메모리를 추가하거나 제거할 수 있으므로 동적으로 변경될 수 있습니다.

SafeBootMode

True이면 시스템이 안전 부팅 모드로 부팅되었습니다.

VirtualizationFlags

가상화 플래그.

ArchStartedInEl2

이 비트필드는 arc.w의 비트 필드와 동기화된 상태로 유지합니다.

QcSlIsSupported

이 비트필드는 arc.w의 비트 필드와 동기화된 상태로 유지합니다.

Reserved12[2]

다음에 사용하도록 예약됩니다.

DUMMYUNIONNAME2

시스템 상태에 관한 다양한 플래그를 포함하는 압축된 비트 필드입니다. 연동 연산을 사용하여 조작해야 합니다. 정확한 결과를 얻으려면 RtlIsMultiSessionSku API를 통해 DbgMultiSessionSku에 액세스해야 합니다.

DUMMYUNIONNAME2.SharedDataFlags

ULONG 멤버 SharedDataFlags를 정의합니다.

DUMMYUNIONNAME2.DUMMYSTRUCTNAME2

DUMMYSTRUCTNAME2 구조를 정의합니다.

DUMMYUNIONNAME2.DUMMYSTRUCTNAME2.DbgErrorPortPresent