IDWriteFontFile::Analyze method

Analyzes a file and returns whether it represents a font, and whether the font type is supported by the font system.

Syntax

virtual HRESULT Analyze(
  [out]           BOOL                  * isSupportedFontType,
  [out]           DWRITE_FONT_FILE_TYPE * fontFileType,
  [out, optional] DWRITE_FONT_FACE_TYPE * fontFaceType,
  [out]           UINT32                * numberOfFaces
) = 0;

Parameters

isSupportedFontType [out]

Type: BOOL*

TRUE if the font type is supported by the font system; otherwise, FALSE.

fontFileType [out]

Type: DWRITE_FONT_FILE_TYPE*

When this method returns, contains a value that indicates the type of the font file. Note that even if isSupportedFontType is FALSE, the fontFileType value may be different from DWRITE_FONT_FILE_TYPE_UNKNOWN.

fontFaceType [out, optional]

Type: DWRITE_FONT_FACE_TYPE*

When this method returns, contains a value that indicates the type of the font face. If fontFileType is not equal to DWRITE_FONT_FILE_TYPE_UNKNOWN, then that can be constructed from the font file.

numberOfFaces [out]

Type: UINT32*

When this method returns, contains the number of font faces contained in the font file.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Requirements

See also

IDWriteFontFile