IDWriteFontResource::GetFontAxisRanges method (dwrite_3.h)

Retrieves the value ranges of each axis.

Syntax

HRESULT GetFontAxisRanges(
  [out] DWRITE_FONT_AXIS_RANGE *fontAxisRanges,
        UINT32                 fontAxisRangeCount
);

Parameters

[out] fontAxisRanges

Type: DWRITE_FONT_AXIS_RANGE*

A pointer to an array of DWRITE_FONT_AXIS_RANGE structures into which GetFontAxisRanges writes the list of font axis value ranges. You're responsible for managing the size and the lifetime of this array. Call GetFontAxisCount to determine the size of array to allocate.

fontAxisRangeCount

Type: UINT32

The maximum number of font axis value ranges to write into the memory block pointed to by fontAxisRanges.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Return value Description
E_INVALIDARG fontAxisValueCount doesn't match the value returned by GetFontAxisCount.

Remarks

A non-varying axis has an empty range (minValue == maxValue).

Requirements

Requirement Value
Minimum supported client Windows 10 Build 20348
Minimum supported server Windows 10 Build 20348
Target Platform Windows
Header dwrite_3.h
Library Dwrite.lib