Share via

FDQUERYFONTFILE (Compact 2013)

  • Article

3/28/2014

The FDQUERYFONTFILE function provides font file information.

Syntax

LONG FDQUERYFONTFILE(
    ULONG_PTR iFile,
    ULONG ulMode,
    ULONG cjBuf,
    ULONG *pulBuf
);

Parameters

  • iFile
    [in] Pointer to a driver-defined value that identifies the driver font file. This pointer is returned by a prior call to FDLOADFONTFILE.

  • ulMode
    [in] Specifies the type of information to be written. This parameter can be one of the following values:

    Value

    Meaning

    QFF_DESCRIPTION

    The function provides a string that an NT-based operating system will use to describe the font file. A null-terminated Unicode string is written to the buffer pointed to by pulBuffer.

    QFF_NUMFACES

    The function returns the number of typefaces in the font file; the cjBuf and pulBuf parameters are ignored. Typefaces are identified by an index ranging from one through the number of typefaces.
  • cjBuf
    [in] Specifies the size, in bytes, of the return buffer.
  • pulBuf
    [in] Pointer to the return buffer.

Return Value

If ulMode is QFF_NUMFACES, then the return value is the number of faces in the font file. If pulBuf is NULL, it is the number of bytes of data that would be written to pulBuf; otherwise, it is the number of bytes written to pulBuf. If an error occurs, the return value is FD_ERROR.

Remarks

FDQUERYFONTFILE is required for font drivers.

Requirements

Header

fontdrv.h

See Also

Reference

Fonts Functions