OSVERSIONINFOEXW 구조체(wdm.h)

RTL_OSVERSIONINFOEXW 구조에는 운영 체제 버전 정보가 포함됩니다.

구문

typedef struct _OSVERSIONINFOEXW {
  ULONG  dwOSVersionInfoSize;
  ULONG  dwMajorVersion;
  ULONG  dwMinorVersion;
  ULONG  dwBuildNumber;
  ULONG  dwPlatformId;
  WCHAR  szCSDVersion[128];
  USHORT wServicePackMajor;
  USHORT wServicePackMinor;
  USHORT wSuiteMask;
  UCHAR  wProductType;
  UCHAR  wReserved;
} OSVERSIONINFOEXW, *POSVERSIONINFOEXW, *LPOSVERSIONINFOEXW, RTL_OSVERSIONINFOEXW, *PRTL_OSVERSIONINFOEXW;

멤버

dwOSVersionInfoSize

RTL_OSVERSIONINFOEXW 구조체의 크기(바이트)입니다. 구조체가 RtlGetVersion과 함께 사용되기 전에 이 멤버를 설정해야 합니다.

dwMajorVersion

운영 체제의 주 버전 번호입니다. 예를 들어 Windows 2000의 경우 주 버전 번호는 5개입니다. 자세한 내용은 주의 표를 참조하세요.

dwMinorVersion

운영 체제의 부 버전 번호입니다. 예를 들어 Windows 2000의 경우 부 버전 번호는 0입니다. 자세한 내용은 주의 표를 참조하세요.

dwBuildNumber

운영 체제의 빌드 번호입니다.

dwPlatformId

운영 체제 플랫폼입니다. NT 기반 운영 체제에서 Win32의 경우 RtlGetVersion 은 VER_PLATFORM_WIN32_NT 값을 반환합니다.

szCSDVersion[128]

서비스 팩 버전 문자열입니다. 이 멤버에는 시스템에 설치된 최신 서비스 팩을 나타내는 "서비스 팩 3"과 같은 null로 종료된 문자열이 포함되어 있습니다. 서비스 팩이 설치되어 있지 않으면 RtlGetVersion 에서 이 문자열을 초기화하지 않을 수 있습니다. RtlGetVersion을 호출하기 전에 szCSDVersion을 0(빈 문자열)으로 초기화합니다.

wServicePackMajor

시스템에 설치된 최신 서비스 팩의 주 버전 번호입니다. 예를 들어 서비스 팩 3의 경우 주 버전 번호는 3입니다. 서비스 팩이 설치되지 않은 경우 값은 0입니다.

wServicePackMinor

시스템에 설치된 최신 서비스 팩의 부 버전 번호입니다. 예를 들어 서비스 팩 3의 경우 부 버전 번호는 0입니다.

wSuiteMask

시스템에서 사용할 수 있는 제품 제품군입니다. 이 멤버는 다음 값 중 하나 이상의 비트 OR 또는 0으로 설정됩니다.

small Business Server가 현재 설치되어 있는지 여부를 확인하기 위해 VER_SUITE_SMALLBUSINESS 플래그에만 의존해서는 안 됩니다. 이 제품 제품군이 설치되면 이 플래그와 VER_SUITE_SMALLBUSINESS_RESTRICTED 플래그가 모두 설정됩니다. 이 설치를 Windows Server Standard Edition으로 업그레이드하면 VER_SUITE_SMALLBUSINESS_RESTRICTED 플래그가 지워지지만 VER_SUITE_SMALLBUSINESS 플래그가 설정된 상태로 유지됩니다. 이 경우 Small Business Server가 이전에 이 시스템에 설치되었음을 나타냅니다. 이 설치가 Windows Server로 추가로 업그레이드되면 Enterprise Edition VER_SUITE_SMALLBUSINESS 플래그가 설정된 상태로 유지됩니다.

wProductType

제품 유형입니다. 이 멤버에는 시스템에 대한 추가 정보가 포함되어 있습니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

wReserved

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

설명

이 구조의 정보에는 주 버전 및 부 버전 번호, 빌드 번호, 플랫폼 식별자, 설치된 제품 제품군 및 시스템에 설치된 최신 서비스 팩이 포함됩니다. 이 구조체는 RtlGetVersion 및 RtlVerifyVersionInfo 루틴과 함께 사용됩니다.

버전 정보를 사용하는 것이 항상 기능을 사용할 수 있는지 여부를 테스트하는 가장 좋은 방법은 아닙니다. 지침은 관심 있는 기능에 대한 설명서를 참조하세요.

가능하면 드라이버에서 버전 검색 코드를 디자인하여 드라이버가 이후 버전의 Windows에서 실행되도록 합니다. 드라이버에 특정 운영 체제 버전이 필요한 경우 이 버전을 드라이버가 실행할 수 있는 유일한 버전이 아니라 지원되는 최소 버전으로 처리해야 합니다.

다음 표에는 지원되는 Windows 버전에서 반환되는 버전 정보가 요약되어 있습니다. "기타" 열 또는 빌드 번호의 정보를 사용하여 버전 번호가 동일한 운영 체제를 구분합니다.

Windows XP Professional x64 Edition에서는 64비트 커널 모드 드라이버만 실행할 수 있습니다. 따라서 32비트 커널 모드 드라이버는 이 버전의 Windows에 대한 검사를 안전하게 생략할 수 있습니다.

요구 사항

추가 정보

RTL_OSVERSIONINFOW

RtlGetVersion

RtlVerifyVersionInfo