Fungsi DWriteCreateFactory (dwrite.h)

Membuat objek pabrik DirectWrite yang digunakan untuk pembuatan objek DirectWrite individual berikutnya.

Sintaks

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

Parameter

[in] factoryType

Jenis: DWRITE_FACTORY_TYPE

Nilai yang menentukan apakah objek pabrik akan dibagikan atau diisolasi.

[in] iid

Jenis: REFIID

Nilai GUID yang mengidentifikasi antarmuka pabrik DirectWrite, seperti __uuidof(IDWriteFactory).

[out] factory

Jenis: IUnknown**

Alamat penunjuk ke objek pabrik DirectWrite yang baru dibuat.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi ini membuat objek pabrik DirectWrite yang digunakan untuk pembuatan objek DirectWrite individual berikutnya. DirectWrite factory berisi data status internal seperti pendaftaran pemuat font dan data font yang di-cache. Dalam kebanyakan kasus, disarankan agar Anda menggunakan objek pabrik bersama, karena memungkinkan beberapa komponen yang menggunakan DirectWrite untuk berbagi data status DirectWrite internal, dan dengan demikian mengurangi penggunaan memori. Namun, ada kasus ketika diinginkan untuk mengurangi dampak komponen, seperti plug-in dari sumber yang tidak tepercaya, pada sisa proses, dengan kotak pasir dan mengisolasinya dari komponen proses lainnya. Dalam kasus seperti itu, disarankan Anda menggunakan pabrik yang terisolasi untuk komponen terkotakpasir.

Contoh berikut menunjukkan cara membuat pabrik DirectWrite bersama.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	dwrite.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll