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.

Macro	Description
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.

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);

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.