Assert and Breakpoint Macros
[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 DirectShow Base Classes provide several macros that perform asserts or cause breakpoints.
| Macro | Description |
|---|---|
| ASSERT | Evaluates an expression, and displays a diagnostic message if the expression is FALSE. |
| DbgAssertAligned | Tests whether a pointer is aligned to a specified boundary. |
| DbgBreak | Displays a message box with the specified string, the name of the source file, and the line number. |
| EXECUTE_ASSERT | Evaluates an expression in debug and retail builds. In debug builds, displays a diagnostic message if the expression is FALSE. |
| KASSERT | Evaluates an expression, and causes a breakpoint exception if the expression is FALSE. |
| KDbgBreak | Causes a breakpoint exception, and logs the specified string. |
Related topics