Funzione DWriteCreateFactory (dwrite.h)

Crea un oggetto factory DirectWrite utilizzato per la successiva creazione di singoli oggetti DirectWrite.

Sintassi

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

Parametri

[in] factoryType

Tipo: DWRITE_FACTORY_TYPE

Valore che specifica se l'oggetto factory verrà condiviso o isolato.

[in] iid

Tipo: REFIID

Valore GUID che identifica l'interfaccia di DirectWrite factory, ad esempio __uuidof(IDWriteFactory).

[out] factory

Tipo: IUnknown**

Indirizzo di un puntatore all'oggetto factory appena creato DirectWrite.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione crea un oggetto factory DirectWrite utilizzato per la successiva creazione di singoli oggetti DirectWrite. DirectWrite factory contiene dati di stato interni, ad esempio la registrazione del caricatore di tipi di carattere e i dati dei tipi di carattere memorizzati nella cache. Nella maggior parte dei casi è consigliabile usare l'oggetto factory condiviso, perché consente a più componenti che usano DirectWrite di condividere i dati di stato DirectWrite interni e quindi ridurre l'utilizzo della memoria. Tuttavia, esistono casi in cui è consigliabile ridurre l'impatto di un componente, ad esempio un plug-in da un'origine non attendibile, nel resto del processo, eseguendo la sandboxing e isolandola dal resto dei componenti del processo. In questi casi, è consigliabile usare una factory isolata per il componente in modalità sandbox.

Nell'esempio seguente viene illustrato come creare una factory di DirectWrite condivisa.

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

Requisiti