GETINFO_GLYPHSTRING structure (printoem.h)

The GETINFO_GLYPHSTRING structure is used as input to the UNIFONTOBJ_GetInfo callback function.

Syntax

typedef struct _GETINFO_GLYPHSTRING {
  DWORD dwSize;
  DWORD dwCount;
  DWORD dwTypeIn;
  PVOID pGlyphIn;
  DWORD dwTypeOut;
  PVOID pGlyphOut;
  DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;

Members

dwSize

Specifies the size, in bytes, of the GETINFO_GLYPHSTRING structure. This value is supplied by the UNIFONTOBJ_GetInfo caller.

dwCount

Specifies the number of elements in the arrays pointed to by pGlyphIn and pGlyphOut. This value is supplied by the UNIFONTOBJ_GetInfo caller.

dwTypeIn

Specifies the type of glyph specifier array pointed to by pGlyphIn. Valid values are as follows:

Value Definition
TYPE_GLYPHHANDLE TpGlyphIn array elements are of type HGLYPH, or handle to a device font glyph. For this value of dwTypeIn, valid values for dwTypeOut are either TYPE_UNICODE or TYPE_TRANSDATA.
TYPE_GLYPHID The pGlyphIn array elements are of type DWORD, and contain glyph identifiers for downloaded TrueType font glyphs. For this value of dwTypeIn, valid values for dwTypeOut are either TYPE_UNICODE or TYPE_GLYPHHANDLE.

Supplied by the UNIFONTOBJ_GetInfo caller.

pGlyphIn

Pointer to an array of glyph specifiers. The array element type is indicated by dwTypeIn. This value is supplied by the UNIFONTOBJ_GetInfo caller.

dwTypeOut

Specifies the type of glyph specifier array pointed to by pGlyphOut. Valid values are as follows:

Value Definition
TYPE_GLYPHHANDLE The pGlyphOut array elements are of type HGLYPH, or handle to a device font glyph. This value is valid only when dwTypeIn has been set to TYPE_GLYPHID.
TYPE_TRANSDATA The pGlyphOut array elements are of type TRANSDATA. This value is valid only when dwTypeIn has been set to TYPE_GLYPHHANDLE.
TYPE_UNICODE The pGlyph array elements are of type WCHAR. This value is valid when dwTypeIn has been set to either TYPE_GLYPHHANDLE or TYPE_GLYPHID.

Supplied by the UNIFONTOBJ_GetInfo caller.

pGlyphOut

Caller-supplied pointer to an empty array of glyph specifiers. The array is filled in by Unidrv's UNIFONTOBJ_GetInfo callback function. The array element type is indicated by dwTypeOut. This pointer is supplied by the UNIFONTOBJ_GetInfo caller.

dwGlyphOutSize

Specifies the size, in bytes, of the buffer pointed to by pGlyphOut. This member is used only when dwTypeIn has been set to TYPE_GLYPHHANDLE and dwTypeOut has been set to TYPE_TRANSDATA. See the following Remarks section for more information.

Remarks

To convert an array of glyph specifiers from one type to another, a rendering plug-in can supply the address of a GETINFO_GLYPHSTRING structure when calling Unidrv's UNIFONTOBJ_GetInfo callback function.

If the conversion is from TYPE_GLYPHHANDLE to TYPE_TRANSDATA, UNIFONTOBJ_GetInfo must be called twice.

  • Before the first call to UNIFONTOBJ_GetInfo, the rendering plug-in fills in the dwSize, dwCount, dwTypeIn, and pGlyphIn members and sets dwGlyphOutSize member to zero.

    After UNIFONTOBJ_GetInfo returns, the dwGlyphOutSize member contains the size, in bytes, of the buffer needed to store the converted string.

  • The plug-in allocates a block of memory of the size received in the dwGlyphOutSize member, sets the pGlyphOut member to point to this memory block, and calls UNIFONTOBJ_GetInfo once more. UNIDRV then converts the string from TYPE_GLYPHHANDLE to TYPE_TRANSDATA.

The values that a rendering plug-in specifies for the dwTypeInand pGlyphIn members typically are those that were previously received as the dwTypeand pGlyph parameters to the IPrintOemUni::OutputCharStr method.

Requirements

Requirement Value
Header printoem.h (include Printoem.h)

See also

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo