Debug NOTE (Message) Macros

The NOTE macros provide debug message abilities in the Microsoft® Foundation Class Library (MFC) style. For more information about how the NOTE macros are implemented, see Debug Logging by Module Level. The NOTE macros work like a call to DbgLog, with a message type of LOG_TRACE, and a logging level of 5. For more information about how NOTE macros choose the debug output location, see Debug Output Location.
NOTE Logs a debug message with zero additional parameters.
NOTE1 Logs a debug message with one additional parameter.
NOTE2 Logs a debug message with two additional parameters.
NOTE3 Logs a debug message with three additional parameters.
NOTE4 Logs a debug message with four additional parameters.
NOTE5 Logs a debug message with five additional parameters.

NOTE through NOTE5 Macros

Will format and print their parameters on the debugger.

Syntax

NOTE(
  pFormat
  );
NOTEx(
  pFormat,
  [a-e]
  );

Parameters

pFormat
A printf-style format string, which must be in quotation marks.
a through e
Optional parameters, each of which must have a respective format string portion (such as "%d").

Remarks

These macros are ignored unless DEBUG is defined when the Microsoft® DirectShow® headers are included. The following example shows the syntax for the NOTE1 through NOTE5 macros.

NOTE1(pFormat, a);
NOTE2(pFormat, a, b);
NOTE3(pFormat, a, b, c);
NOTE4(pFormat, a, b, c, d);
NOTE5(pFormat, a, b, c, d, e);

Top of Page Top of Page
© 2000 Microsoft and/or its suppliers. All rights reserved. Terms of Use.