EngFntCacheFault function (winddi.h)

Article
02/22/2024

The EngFntCacheFault function reports an error to the font engine if the font driver encountered an error reading from or writing to a font data cache.

Syntax

ENGAPI VOID EngFntCacheFault(
  [in] ULONG ulFastCheckSum,
  [in] ULONG iFaultMode
);

Parameters

[in] ulFastCheckSum

Specifies the checksum for the font.

[in] iFaultMode

Specifies the type of error that occurred. This parameter can be one of the following values:

Value	Meaning
ENG_FNT_CACHE_READ_FAULT	An error occurred during retrieval.
ENG_FNT_CACHE_WRITE_FAULT	An error occurred during storage.

Return value

None

Remarks

If an error occurs while the font driver was reading from or writing to the font data cache, it should report the error to the font engine by a call to this function.

The font engine calls the font driver's DrvLoadFontFile entry point when a font file is first loaded. It is in this call that the font driver receives a value for ulFastCheckSum, which it subsequently uses when it calls this function.

Requirements

Requirement	Value
Minimum supported client	This function is available in Windows XP and later.
Target Platform	Universal
Header	winddi.h (include Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys