Función DWriteCreateFactory (dwrite.h)

Crea un objeto de fábrica DirectWrite que se usa para la creación posterior de objetos de DirectWrite individuales.

Sintaxis

HRESULT DWriteCreateFactory(
  [in]  DWRITE_FACTORY_TYPE factoryType,
  [in]  REFIID              iid,
  [out] IUnknown            **factory
);

Parámetros

[in] factoryType

Tipo: DWRITE_FACTORY_TYPE

Valor que especifica si el objeto de fábrica se compartirá o aislará.

[in] iid

Tipo: REFIID

Valor GUID que identifica la interfaz de fábrica de DirectWrite, como __uuidof(IDWriteFactory).

[out] factory

Tipo: IUnknown**

Dirección de un puntero al objeto de fábrica DirectWrite recién creado.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función crea un objeto de fábrica DirectWrite que se usa para la creación posterior de objetos DirectWrite individuales. DirectWrite generador contiene datos de estado internos, como el registro del cargador de fuentes y los datos de fuente almacenados en caché. En la mayoría de los casos, se recomienda usar el objeto de fábrica compartido, ya que permite que varios componentes que usen DirectWrite compartan datos de estado internos de DirectWrite y, por tanto, reduzca el uso de memoria. Sin embargo, hay casos en los que es conveniente reducir el impacto de un componente, como un complemento de un origen que no es de confianza, en el resto del proceso, mediante el espacio aislado y aislarlo del resto de los componentes del proceso. En tales casos, se recomienda usar un generador aislado para el componente de espacio aislado.

En el ejemplo siguiente se muestra cómo crear un generador de DirectWrite compartido.

if (SUCCEEDED(hr))
{
    hr = DWriteCreateFactory(
        DWRITE_FACTORY_TYPE_SHARED,
        __uuidof(IDWriteFactory),
        reinterpret_cast<IUnknown**>(&pDWriteFactory_)
        );
}

Requisitos