Boost logo

Boost :

Subject: Re: [boost] [winapi] Default target Windows version
From: Andrey Semashev (andrey.semashev_at_[hidden])
Date: 2013-10-22 09:30:13

On Wednesday 16 October 2013 00:50:21 you wrote:
> Hi,
> First, a little intro. As part of ongoing work on Boost.Sync we've created
> quite a few headers with WinAPI declarations that are often needed in Boost
> libraries. The headers are in boost/detail/winapi and can be used by any
> library that wishes to avoid including windows.h.
> The headers declare some symbols that depend on the target Windows version.
> For example, GetTickCount64 only appeared in Windows Vista. The user can
> define BOOST_USE_WINAPI_VERSION macro before including any Boost headers to
> indicate the target WinAPI version Boost should use. If the macro is not
> defined, the headers attempt to deduce the target Windows version from the
> _WIN32_WINNT and WINVER macros, if they are defined by the user. Lastly, if
> everything fails, the headers fall back to a default, which is currently
> Windows XP.
> I wanted to ask the community if it is appropriate to raise the default to
> Windows Vista. The rationale for this is that Vista introduced a lot of
> useful APIs (in thread synchronization, in particular) and XP is losing its
> popularity and soon will be completely unsupported by Microsoft. Also, I'm
> not sure what is the current state of affair, but Microsoft already tried
> to drop pre-Vista targets in MSVC.
> Note that I'm not suggesting to drop support for pre-Vista Windows. The user
> will still be able to enable previous versions of WinAPI in one of the
> mentioned above ways.
> Lastly, I'd like to encourage Boost developers to use this protocol for
> defining WinAPI version used by libraries. It would be ideal if by defining
> BOOST_USE_WINAPI_VERSION the user would be able to control WinAPI version
> used by all Boost libraries, not just Boost.Sync and Boost.Chrono (the
> current users of these headers). If you want to add support for this
> protocol to your library, simply include boost/detail/winapi/config.hpp.
> This will result in BOOST_USE_WINAPI_VERSION being defined so that it can
> be checked by the library. Other headers boost/detail/winapi make use of
> this macro, you can see them as an example.

Since there were no objections, I've changed the default to Vista. Please, let
me know if there are problems with it.

Boost list run by bdawes at, gregod at, cpdaniel at, john at