DbgLog macro

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The DbgLog macro sends a string to the debug output ___location, if logging is enabled for the specified type and level. This macro is ignored in retail builds.

Syntax

void DbgLog(
         DWORD Types,
         DWORD Level,
   const TCHAR *pFormat,
               ...
);

Parameters

Types

Bitwise combination of one or more message types.

Level

Logging level for this message.

pFormat

A printf -style format string.

...

Additional arguments for the format string.

Return value

This macro does not return a value.

Remarks

If debug logging for any of the message types is set to the specified level or higher, this macro sends the formatted string to the debug output ___location.

The macro automatically adds a newline character to the output string.

DbgLog((LOG_TRACE, 3, TEXT("Connected input pin %d"), nPinNumber));

Requirements

See also

Debug Output Functions