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，主要版本號碼是五個。 如需詳細資訊，請參閱中的表格。

dwMinorVersion

操作系統的次要版本號碼。 例如，針對 Windows 2000，次要版本號碼為零。 如需詳細資訊，請參閱中的表格。

dwBuildNumber

操作系統的組建編號。

dwPlatformId

操作系統平臺。 針對 NT 型作業系統上的 Win32，RtlGetVersion 會傳回值VER_PLATFORM_WIN32_NT。

szCSDVersion[128]

Service-Pack 版本字串。 此成員包含以 Null 結尾的字串，例如 「Service Pack 3」，表示安裝在系統上的最新 Service Pack。 如果未安裝 Service Pack，RtlGetVersion 可能不會初始化此字串。 在呼叫 RtlGetVersion 之前，將 szCSDVersion 初始化為零 (空字串) 。

wServicePackMajor

安裝在系統上的最新 Service Pack 主要版本號碼。 例如，針對 Service Pack 3，主要版本號碼是三個。 如果未安裝 Service Pack，此值為零。

wServicePackMinor

安裝在系統上的最新 Service Pack 次要版本號碼。 例如，針對 Service Pack 3，次要版本號碼為零。

wSuiteMask

系統上可用的產品套件。 這個成員會設定為零，或設定為下列一或多個值的位 OR。

您不應該只依賴 VER_SUITE_SMALLBUSINESS 旗標來判斷是否目前已安裝 Small Business Server。 安裝此產品套件時，會設定此旗標和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

保留供未來使用。

備註

此結構中的資訊包括主要和次要版本號碼、組建編號、平臺標識碼、已安裝的產品套件，以及安裝在系統上的最新 Service Pack。 此結構會與 RtlGetVersion 和 RtlVerifyVersionInfo 例程搭配使用。

依賴版本資訊不一定是測試功能是否可用的最佳方式。 如需指引，請參閱您感興趣的功能檔。

可能的話，請在驅動程式中設計版本偵測程式代碼，讓驅動程式能夠在未來的 Windows 版本上執行。 如果您的驅動程式需要特定的作業系統版本，請務必將此版本視為最低支援的版本，而不是驅動程式可執行的唯一版本。

下表摘要說明支援的 Windows 版本所傳回的版本資訊。 使用 [其他] 數據行或組建編號中的資訊，區分具有相同版本號碼的操作系統。

只有 64 位內核模式驅動程式可以在 Windows XP Professional x64 Edition 上執行。 因此，32 位內核模式驅動程式可以安全地省略此版本的 Windows 檢查。

規格需求

另請參閱

RTL_OSVERSIONINFOW

RtlGetVersion

RtlVerifyVersionInfo