VioQueryFonts

Gets the position at which the presentation space maps to the window.

Syntax
VioQueryFonts (Remfonts, Metrics, Metlen, Fonts, Facename, Options, hvps)

Parameters

 * Remfonts (PULONG) - output : Number of fonts not returned.
 * The number of fonts for which information is not returned.


 * Metrics (PFONTMETRICS) - output : Font metrics.
 * Matching font metrics are returned in this buffer.


 * Metlen (ULONG) - input : Maximum length of data.
 * The maximum length of data to be returned for each record.


 * Fonts (PULONG) - in/out : Number of fonts.
 * The location of the number of fonts to be returned on input. This is updated with the actual number of fonts returned on output.


 * Facename (PSZ) - input : Face name of fonts.
 * The face name of fonts desired, or NULL to indicate that all applicable fonts should be returned.


 * Options (ULONG) - input : Controls which fonts are selected.
 * Valid values are:
 * VQF_PUBLIC - Return only public fonts.
 * VQF_PRIVATE - Return only private fonts.
 * VQF_ALL - Return both public and private fonts.


 * hvps (HVIO) - input : VIO presentation-space handle.
 * This is either 0 to indicate the default VIO session, or a value returned by VioCreatePS.

Return Code
rc (APIRET) - returns VioQueryFonts returns one of the following values:
 * 0         NO_ERROR
 * 421       ERROR_VIO_INVALID_PARMS
 * 436       ERROR_VIO_INVALID_HANDLE

Remarks
By inspecting the returned font metrics, the application can choose the font that best meets its requirements.

All metrics are returned in pel coordinates.

In OS/2 2.x, hvps cannot be zero.