DWRITE_FACTORY_TYPE列挙 (dwrite.h)

  • [アーティクル]

ファクトリ オブジェクトの種類DirectWrite指定します。

重要

この API は、DirectWriteの DWriteCore 実装の一部として使用できます。 詳細とコード例については、「 DWriteCore の概要」を参照してください。

構文

typedef enum DWRITE_FACTORY_TYPE {
  DWRITE_FACTORY_TYPE_SHARED,
  DWRITE_FACTORY_TYPE_ISOLATED,
  DWRITE_FACTORY_TYPE_ISOLATED2
} ;

定数

 
DWRITE_FACTORY_TYPE_SHARED
DirectWrite ファクトリが共有ファクトリであり、複数のインプロセス コンポーネント間でキャッシュされたフォント データを再利用することを示します。 このようなファクトリでは、パフォーマンスを向上させるためにクロスプロセス フォント キャッシュ コンポーネントも利用されます。
DWRITE_FACTORY_TYPE_ISOLATED
DirectWrite ファクトリ オブジェクトが分離されていることを示します。 分離ファクトリから作成されたオブジェクトは、他のコンポーネントの内部DirectWrite状態と対話しません。
DWRITE_FACTORY_TYPE_ISOLATED2
DirectWrite ファクトリ オブジェクトが制限されていることを示します。 制限付きファクトリから作成されたオブジェクトは、他のファクトリで使用される内部状態やキャッシュされたデータを使用したり変更したりしません。 さらに、システム フォント コレクションには、既知のフォントのみが含まれています。

## の例

DWriteCore の概要に関するトピックと DWriteCoreGallery サンプル アプリを参照してください。

注釈

DirectWrite ファクトリ オブジェクトには、フォント ローダーの登録やキャッシュされたフォント データなど、内部状態に関する情報が含まれています。 ほとんどの場合、共有ファクトリ オブジェクトを使用する必要があります。これは、DirectWriteを使用する複数のコンポーネントで内部DirectWrite状態情報を共有できるため、メモリ使用量が削減されるためです。 ただし、信頼されていないソースからのプラグインなど、プロセスの残りの部分に対するコンポーネントの影響を軽減するために、プロセス コンポーネントの残りの部分からサンドボックス化して分離することが望ましい場合があります。 このような場合は、サンドボックス コンポーネントに分離ファクトリを使用する必要があります。

制限付きファクトリは、分離されたファクトリよりもロックダウンされています。 クロスプロセスや永続的なフォント キャッシュとは何もやり取りしません。 さらに、このファクトリから返されるシステム フォント コレクションには、既知のフォントのみが含まれています。 DWriteCore より古いバージョンの DWrite に DWRITE_FACTORY_TYPE_ISOLATED2 を渡すと、 DWriteCreateFactory は E_INVALIDARGを返します。

要件

要件 値
サポートされている最小のクライアント Windows 10 Version 1809 (Windows アプリ SDK 0.5 以降)
Header dwrite.h

こちらもご覧ください

DWriteCore

DWriteCoreGallery サンプル