DWriteCreateFactory 함수(dwrite.h)

개별 DirectWrite 개체의 후속 생성에 사용되는 DirectWrite 팩터리 개체를 만듭니다.

구문

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

매개 변수

[in] factoryType

형식: DWRITE_FACTORY_TYPE

팩터리 개체를 공유할지 격리할지 여부를 지정하는 값입니다.

[in] iid

형식: REFIID

__uuidof(IDWriteFactory)와 같은 DirectWrite 팩터리 인터페이스를 식별하는 GUID 값입니다.

[out] factory

형식: IUnknown**

새로 만든 DirectWrite 팩터리 개체에 대한 포인터의 주소입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 개별 DirectWrite 개체의 후속 생성에 사용되는 DirectWrite 팩터리 개체를 만듭니다. DirectWrite 팩터리에는 글꼴 로더 등록 및 캐시된 글꼴 데이터와 같은 내부 상태 데이터가 포함됩니다. 대부분의 경우 공유 팩터리 개체를 사용하는 것이 좋습니다. DirectWrite 사용하는 여러 구성 요소가 내부 DirectWrite 상태 데이터를 공유하여 메모리 사용량을 줄일 수 있기 때문입니다. 그러나 신뢰할 수 없는 원본의 플러그 인과 같은 구성 요소가 프로세스의 나머지 부분에 미치는 영향을 샌드박싱하고 나머지 프로세스 구성 요소에서 격리하는 것이 바람직한 경우가 있습니다. 이러한 경우 샌드박스 구성 요소에 대해 격리된 팩터리를 사용하는 것이 좋습니다.

다음 예제에서는 공유 DirectWrite 팩터리를 만드는 방법을 보여 줍니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll