Funzione DWriteCreateFactory (dwrite.h)

Articolo
08/23/2023

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

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dwrite.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Condividi tramite