Windows sysinternals

Chapter 7 Process and Diagnostic Utilities 243
shown in Figure 7-14. The Include and Exclude fields are used to set criteria for including or
excluding incoming lines of debug text based on their content. The Highlight group box is
used to color-code selected lines based on their content. Filter and Highlight rules can be
saved to disk and then reloaded at a later time. (Highlighting is discussed in the next section
of this chapter.)
FIGURE 7-14 The DebugView Filter dialog box.
Enter substring expressions in the Include field that match debug output lines that you want
DebugView to display, and enter substring expressions in the Exclude field to specify debug
output lines that you do not want DebugView to display. You can enter multiple expressions,
separating each with a semicolon. Do not include spaces in the filter expression unless you
want the spaces to be part of the filter. Note that the “*” character is interpreted as a wildcard,
and that filters are interpreted in a case-insensitive manner and are also applied to the
Process ID portion of the line if PIDs are included in the output. The default rules include
everything (“*”) and exclude nothing.
As shown in the example in Figure 7-14, say that you want DebugView to display debug
output only if it contains the words “win,” “desk,” or “session,” unless it also contains the
word “error.” Set the Include filter to “win;desk;session” (without the quotes) and the
Exclude filter to “error.” If you want DebugView to show only output that has “MyApp:”
and the word “ severe” following later in the output line, use a wildcard in the Include filter:
“myapp:*severe”.
Filtering is applied only to new lines of debug output as they are captured and to comments
appended with the Append Comment feature. New text lines that match the rules that are
in effect are displayed; those that don’t match are dropped and cannot be “unhidden” by
changing the filter rules after the fact. Also, changing the filter rules does not remove lines
that are already displayed by DebugView.
If any filter rules are in effect when you exit DebugView, DebugView will display them in a
dialog box the next time you start it. Simply click OK to continue using those rules, or change
them first. You can edit them in place, click Load to use a previously saved filter, or click Reset
to remove the filter. To bypass this dialog box and continue to use the rules that were in
effect, add /f to the DebugView command line.
www.it-ebooks.info