Breyta

Deila með


Specifying the Threading Model for a Project (ATL)

The following macros are available to specify the threading model of an ATL project:

Macro Guidelines for using
_ATL_SINGLE_THREADED Define if all of your objects use the single threading model.
_ATL_APARTMENT_THREADED Define if one or more of your objects use apartment threading.
_ATL_FREE_THREADED Define if one or more of your objects use free or neutral threading. Existing code may contain references to the equivalent macro _ATL_MULTI_THREADED.

If you do not define any of these macros for your project, _ATL_FREE_THREADED will be in effect.

The macros affect run-time performance as follows:

  • Specifying the macro that corresponds to the objects in your project can improve run-time performance.

  • Specifying a higher level of macro, for example if you specify _ATL_APARTMENT_THREADED when all of your objects are single threaded, will slightly degrade run-time performance.

  • Specifying a lower level of macro, for example, if you specify _ATL_SINGLE_THREADED when one or more of your objects use apartment threading or free threading, can cause your application to fail at run time.

See Options, ATL Simple Object Wizard for a description of the threading models available for an ATL object.

See also

Concepts