CFIX_FAIL

Use CFIX_FAIL to unconditionally fail a test.

The macro allows printf-style formatting to construct the message. Consult the documentation of printf for a list of format specifiers.

void CFIX_FAIL( 
	__in PCTSTR Format, 
	... 
	);
				

If UNICODE has been defined, string parameters are expected to by of type PCWSTR. Otherwise, ANSI is assumed and string parameters are expected to by of type PCSTR.

In kernel mode, ANSI strings are not supported. Strings are always assumed to by of type PCWSTR. Moreover, formatting can only take place at IRQL <= APC_LEVEL. At higher IRQL, formatting is skipped and the Format string is used as-is.

As variadic macro arguments have not been supported until cl 14.00, this macro is not available if downlevel compilers are used.

void SomeCallback()
{
  CFIX_FAIL( __TEXT( "SomeCallback should not be invoked" ) );
}