KDbgBreak macro

  • Article

[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.]

Causes a breakpoint exception, and logs the specified string using the DbgLog macro. Ignored in retail builds.

Syntax

void KDbgBreak(
    strLiteral
);

Parameters

strLiteral

Text string.

Return value

This macro does not return a value.

Remarks

Unlike the DbgBreak macro, this macro does not display a message box prompting the user. In debug builds, it automatically causes a breakpoint exception to occur.

Requirements

Requirement Value
Header
Wxdebug.h (include Streams.h)

See also

Assert and Breakpoint Macros