Share via


BUILD_PASS0_CONSUMES

The BUILD_PASS0_CONSUMES macro instructs the Build utility to delay building within the specified directory until the same directory that is specified by the corresponding BUILD_PASS0_PRODUCES macro has been built.

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

Syntax

BUILD_PASS0_CONSUMES = 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, you should 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_PASS0_PRODUCES macro with that string is built before any directories with a corresponding BUILD_PASS0_CONSUMES macro.

For example, any directory whose Sources file contains this:

BUILD_PASS0_PRODUCES = ThisDirectory

is built before any directories whose Sources File contains this:

BUILD_PASS0_CONSUMES = ThisDirectory

It is possible to have a consumer directory be affected by more than one producer. In this case, the build process waits for all producers of that directory to complete before finishing.

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_PASS0_CONSUMES = BaseNtosRtlUser

or

BUILD_PASS0_CONSUMES = base_ntos_rtl_user

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

BUILD_PASS0_CONSUMES = Directory1 Directory2 Directory3

See Also

BUILD_PASS0_PRODUCES

Building on a Multiprocessor Computer

Dirs File

Pass 0

Sources File

 

 

Send comments about this topic to Microsoft

Build date: 5/3/2011