SYSTEM_INFO 구조체(sysinfoapi.h)

아티클
08/26/2023

현재 컴퓨터 시스템에 대한 정보를 포함합니다. 여기에는 프로세서의 아키텍처 및 유형, 시스템의 프로세서 수, 페이지 크기 및 기타 정보가 포함됩니다.

구문

typedef struct _SYSTEM_INFO {
  union {
    DWORD dwOemId;
    struct {
      WORD wProcessorArchitecture;
      WORD wReserved;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  DWORD     dwPageSize;
  LPVOID    lpMinimumApplicationAddress;
  LPVOID    lpMaximumApplicationAddress;
  DWORD_PTR dwActiveProcessorMask;
  DWORD     dwNumberOfProcessors;
  DWORD     dwProcessorType;
  DWORD     dwAllocationGranularity;
  WORD      wProcessorLevel;
  WORD      wProcessorRevision;
} SYSTEM_INFO, *LPSYSTEM_INFO;

멤버

DUMMYUNIONNAME

DUMMYUNIONNAME.dwOemId

호환성을 위해 유지되는 사용되지 않는 멤버입니다. 애플리케이션은 공용 구조체의 wProcessorArchitecture 분기를 사용해야 합니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.wProcessorArchitecture

설치된 운영 체제의 프로세서 아키텍처입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
PROCESSOR_ARCHITECTURE_AMD64 9	x64(AMD 또는 Intel)
PROCESSOR_ARCHITECTURE_ARM 5	ARM
PROCESSOR_ARCHITECTURE_ARM64 12	ARM64
PROCESSOR_ARCHITECTURE_IA64 6	Intel Itanium 기반
PROCESSOR_ARCHITECTURE_INTEL 0	x86
PROCESSOR_ARCHITECTURE_UNKNOWN 0xffff	알 수 없는 아키텍처입니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.wReserved

이 멤버는 나중에 사용하도록 예약되어 있습니다.

dwPageSize

페이지 크기 및 페이지 보호 및 약정의 세분성입니다. VirtualAlloc 함수에서 사용하는 페이지 크기입니다.

lpMinimumApplicationAddress

애플리케이션 및 DLL(동적 연결 라이브러리)에서 액세스할 수 있는 가장 낮은 메모리 주소에 대한 포인터입니다.

lpMaximumApplicationAddress

애플리케이션 및 DLL에 액세스할 수 있는 가장 높은 메모리 주소에 대한 포인터입니다.

dwActiveProcessorMask

시스템에 구성된 프로세서 집합을 나타내는 마스크입니다. 비트 0은 프로세서 0입니다. bit 31은 프로세서 31입니다.

dwNumberOfProcessors

현재 그룹의 논리 프로세서 수입니다. 현재 프로세서 그룹을 검색하려면 GetLogicalProcessorInformation 함수를 사용합니다.

참고 논리 프로세서에서 공유하는 물리적 프로세서에 대한 자세한 내용은 RelationshipType 매개 변수가 RelationProcessorPackage(3)로 설정된 GetLogicalProcessorInformationEx를 호출합니다.

dwProcessorType

호환성을 위해 유지되는 사용되지 않는 멤버입니다. wProcessorArchitecture, wProcessorLevel 및 wProcessorRevision 멤버를 사용하여 프로세서 유형을 확인합니다.

PROCESSOR_INTEL_386 (386)

PROCESSOR_INTEL_486 (486)

PROCESSOR_INTEL_PENTIUM (586)

PROCESSOR_INTEL_IA64 (2200)

PROCESSOR_AMD_X8664 (8664)

PROCESSOR_ARM(예약됨)

dwAllocationGranularity

가상 메모리를 할당할 수 있는 시작 주소의 세분성입니다. 자세한 내용은 VirtualAlloc을 참조하세요.

wProcessorLevel

아키텍처 종속 프로세서 수준입니다. 표시 목적으로만 사용해야 합니다. 프로세서의 기능 집합을 확인하려면 IsProcessorFeaturePresent 함수를 사용합니다.

wProcessorArchitecture가 PROCESSOR_ARCHITECTURE_INTEL 경우 wProcessorLevel은 CPU 공급업체에 의해 정의됩니다.

wProcessorArchitecture가 PROCESSOR_ARCHITECTURE_IA64 경우 wProcessorLevel은 1로 설정됩니다.

wProcessorRevision

아키텍처 종속 프로세서 수정 버전입니다. 다음 표에서는 프로세서 아키텍처의 각 유형에 대해 수정 버전 값이 어셈블되는 방법을 보여줍니다.

프로세서	값
Intel Pentium, Cyrix 또는 NextGen 586	높은 바이트는 모델이며, 낮은 바이트는 단계입니다. 예를 들어 값이 xxyy이면 모델 번호와 단계별 실행이 다음과 같이 표시될 수 있습니다. 모델 xx, 스테핑 yy
Intel 80386 또는 80486	xxyz 형식의 값입니다. xx가 0xFF 같으면 y - 0xA 모델 번호이고 z는 단계별 식별자입니다. xx가 0xFF 같지 않으면 xx + 'A'는 단계별 문자이고 yz는 사소한 단계입니다.
ARM	예약되어 있습니다.

프로세서

값

Intel Pentium, Cyrix 또는 NextGen 586

높은 바이트는 모델이며, 낮은 바이트는 단계입니다. 예를 들어 값이 xxyy이면 모델 번호와 단계별 실행이 다음과 같이 표시될 수 있습니다.

모델 xx, 스테핑 yy

Intel 80386 또는 80486

xxyz 형식의 값입니다.

xx가 0xFF 같으면 y - 0xA 모델 번호이고 z는 단계별 식별자입니다.

xx가 0xFF 같지 않으면 xx + 'A'는 단계별 문자이고 yz는 사소한 단계입니다.

ARM

예약되어 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
머리글	sysinfoapi.h(Windows.h 포함)