RxAssert routine

Article
11/28/2017

RxAssert sends an ASSERT string on checked builds of RDBSS to a kernel debugger if one is installed. For retail builds of RDBSS, calls to this routine will bug check.

Syntax

VOID RxAssert(
  _In_     PVOID FailedAssertion,
  _In_     PVOID FileName,
  _In_     ULONG LineNumber,
  _In_opt_ PCHAR Message
);

Parameters

FailedAssertion [in]
The failed assertion.

FileName [in]
The name of the source file where RxAssert or RtlAssert was called.

LineNumber [in]
The line number in the source file where RxAssert or RtlAssert was called.

Message [in, optional]
An optional message.

Return value

None

Remarks

When the rxassert.h include file is used, Windows kernel RtlAssert calls will be redefined to call this RxAssert routine as well.

On retail builds, RxAssert will call KeBugCheckEx passing in the value 0xa55a0000 ORed with the line number as BugCheckParamater1.

Requirements

Target platform	Desktop
Header	Rxassert.h (include Rxassert.h)
IRQL	<= APC_LEVEL

Partager via