EngMapFontFileFD function (winddi.h)

Article
02/22/2024

The EngMapFontFileFD function maps a font file into system memory, if necessary, and returns a pointer to the base location of the font data in the file.

Syntax

ENGAPI BOOL EngMapFontFileFD(
  [in]  ULONG_PTR iFile,
  [out] PULONG    *ppjBuf,
  [out] ULONG     *pcjBuf
);

Parameters

[in] iFile

Caller-supplied pointer to a value that identifies the font file to be mapped. This pointer must have been received previously as input to DrvLoadFontFile.

[out] ppjBuf

Pointer to a memory location that receives the mapped file's base memory address.

[out] pcjBuf

Pointer to a memory location that receives the size, in bytes, of the mapped file.

Return value

EngMapFontFileFD returns TRUE if it succeeds; otherwise, it returns FALSE.

Remarks

The EngMapFontFileFD function is provided so font drivers can map a font file into memory and access the file's data. If the font file has not yet been memory-mapped, EngMapFontFileFD loads the font data into system memory before returning ppjBuf and pcjBuf to the driver. If the file is already mapped, the function just returns the file's ppjBuf and pcjBuf values.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Universal
Header	winddi.h (include Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys