DWriteCoreCreateFactory function (dwrite_core.h)

Article
02/23/2024

Creates a factory object that is used for subsequent creation of individual DWriteCore objects.

Important

This API is available as part of the DWriteCore implementation of DirectWrite. For more info, and code examples, see DWriteCore overview.

Syntax

HRESULT DWriteCoreCreateFactory(
  DWRITE_FACTORY_TYPE factoryType,
  REFIID              iid,
  IUnknown            **factory
);

Parameters

factoryType

Type: DWRITE_FACTORY_TYPE

A value that specifies whether the factory object will be shared, isolated, or restricted.

iid

Type: REFIID

A GUID value that identifies the DirectWrite factory interface, such as __uuidof(IDWriteFactory).

factory

Type: IUnknown**

An address of a pointer to the newly created DirectWrite factory object.

Return value

Type: HRESULT

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

Examples

See the DWriteCore overview topic, and the DWriteCoreGallery sample app.

Remarks

This is functionally the same as the DWriteCreateFactory function exported by the system version of DirectWrite. The DWriteCore function has a different name to avoid ambiguity.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1809 (with Windows App SDK 0.5 or later)
Header	dwrite_core.h