FDQUERYFONTFILE (Windows Embedded CE 6.0)

1/6/2010

Applies to Windows Embedded CE 6.0 R2

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

See Also

Reference

Pluggable Fonts Reference

Other Resources

Fonts Functions
Pluggable Fonts