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
Building on a Multiprocessor Computer
Send comments about this topic to Microsoft
Build date: 5/3/2011