The DrvQueryFont function is used by GDI to get the IFIMETRICS structure for a given font.
Pointer to a driver-defined value that identifies a driver font file. This pointer is returned by DrvLoadFontFile. This parameter is zero for device-resident fonts.
Specifies the one-based index of the driver font. GDI can query the number of fonts from the DEVINFO structure.
Pointer to a memory location holding the address of a driver-defined value that GDI passes to DrvFree when the IFIMETRICS structure is no longer needed. Depending on how the driver manages memory, this value can identify the structure, identify the way it was allocated, or do nothing at all.
The return value is a pointer to the IFIMETRICS structure that describes the given font if the function is successful. Otherwise, it is NULL, and an error code is logged.
The driver fills the IFIMETRICS structure.
The IFIMETRICS structure must remain unchanged during the scope of the associated PDEV.
If the number of fonts in DEVINFO is -1 and iFace is zero, the driver should return the number of fonts it supports.
DrvQueryFont is required for font drivers and drivers that use driver-specific or device-specific fonts.
Build date: 11/16/2013