BUILD_PASS2_PRODUCES

The BUILD_PASS2_PRODUCES macro instructs the Build utility to complete building within the specified directory before the same directory that is specified by the corresponding BUILD_PASS2_CONSUMES macro has been built.

This macro is set in your Sources file and is only applied during Pass 2 of the build process.

Syntax

BUILD_PASS2_PRODUCES = ThisString

Parameters

• ThisString
  A unique string. The names of the directories to be built are specified in the Dirs file. The Dirs file order is always preserved.

  For consistency and uniqueness across the source tree, construct the names in the ThisString parameter either by replacing any backslashes (\) with underscores (_), or by eliminating backslashes and using mixed case text. Directory names are relative to %sdxroot%.

Comments

For any given string specified by the ThisString parameter, the directory whose Sources file contains a BUILD_PASS2_PRODUCES macro with that string is built before any directories with a corresponding BUILD_PASS2_CONSUMES macro.

For example, any directory whose Sources file contains this:

BUILD_PASS2_PRODUCES = ThisDirectory

is built before any directories whose Sources File contains this:

BUILD_PASS2_CONSUMES = ThisDirectory

For more information, see Building on a Multiprocessor Computer.

Examples

For a Sources file in D:\nt\base\ntos\rtl\user, use one of the following options:

BUILD_PASS2_PRODUCES = BaseNtosRtlUser

or

BUILD_PASS2_PRODUCES = base_ntos_rtl_user

If you want to specify multiple BUILD_PASS2_PRODUCES directories in one Sources File, specify the directories on one line and separate them by using a space:

BUILD_PASS2_PRODUCES = Directory1 Directory2 Directory3

See Also

BUILD_PASS2_CONSUMES

Building on a Multiprocessor Computer

Dirs file

Pass 2

Sources File

 

 

Send comments about this topic to Microsoft

Build date: 5/3/2011