Debugging Tools for Windows

DEBUG_OUTCTL_XXX

The DEBUG_OUTCTL_XXX constants are used for output control. The constants form a bit field that specifies the current policy of where to send output. The bit field is divided into two sections.

The lower bits must be exactly one of the following values.

Value Description
DEBUG_OUTCTL_THIS_CLIENT Output generated by methods called by this client will be sent only to this client's output callbacks.
DEBUG_OUTCTL_ALL_CLIENTS Output will be sent to all clients.
DEBUG_OUTCTL_ALL_OTHER_CLIENTS Output will be sent to all clients (except to the client that generated the output).
DEBUG_OUTCTL_IGNORE Output will be discarded immediately and will not be logged or sent to callbacks.
DEBUG_OUTCTL_LOG_ONLY Output will be logged but not sent to callbacks.

The higher bits of the bit field may contain the following values:

Value Description
DEBUG_OUTCTL_NOT_LOGGED Do not place output from this client in the global log file.
DEBUG_OUTCTL_OVERRIDE_MASK Send output to clients regardless of whether the client's output mask allows it or not.

To create a valid output control bit-field, take exactly one value from the first table, along with zero, one, or more values from the second table, and combine them using the bitwise-OR operator. Alternatively, when setting the output control, the value DEBUG_OUTCTL_AMBIENT can be used to set the new output control to the same value as the current output control.

The default value of the output control bit-field is DEBUG_OUTCTL_ALL_CLIENTS.

Requirements

Headers: Defined in DbgEng.h. Include DbgEng.h.

Build machine: CAPEBUILD