IXpsRasterizationFactory::CreateRasterizer 메서드(xpsrassvc.h)

CreateRasterize 메서드는 XPS 래스터라이저 개체를 만듭니다.

구문

HRESULT CreateRasterizer(
  [in, optional]  IXpsOMPage            *xpsPage,
  [in]            FLOAT                 DPI,
  [in]            XPSRAS_RENDERING_MODE nonTextRenderingMode,
  [in]            XPSRAS_RENDERING_MODE textRenderingMode,
  [out, optional] IXpsRasterizer        **ppIXPSRasterizer
);

매개 변수

[in, optional] xpsPage

렌더링할 XPS 고정 페이지를 나타내는 IXpsOMPage 개체에 대한 포인터입니다. 이 개체는 XPS 문서에서 FixedPage 섹션을 캡슐화합니다. 자세한 내용은 IXpsOMPage를 참조하세요.

[in] DPI

래스터화된 출력의 인치당 점입니다. 이 매개 변수는 출력 비트맵의 x 차원과 y 차원 모두에 적용됩니다. DPI 값은 XPS 고정 페이지를 인쇄하거나 표시하는 디바이스의 해상도입니다.

[in] nonTextRenderingMode

래스터화된 출력의 텍스트가 아닌 항목에 대한 렌더링 모드입니다. 이 매개 변수는 앤티앨리어스 출력을 생성할지 여부를 나타냅니다. 이 매개 변수를 다음 XPSRAS_RENDERING_MODE 열거형 값 중 하나로 설정합니다.

• XPSRAS_RENDERING_MODE_ANTIALIASED

• XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

래스터화된 출력의 텍스트에 대한 렌더링 모드입니다. 이 매개 변수는 앤티앨리어스 출력을 생성할지 여부를 나타냅니다. 이 매개 변수를 다음 XPSRAS_RENDERING_MODE 열거형 값 중 하나로 설정합니다.

• XPSRAS_RENDERING_MODE_ANTIALIASED

• XPSRAS_RENDERING_MODE_ALIASED

[out, optional] ppIXPSRasterizer

이 매개 변수는 메서드가 새로 만든 XPS 래 스터라이저 개체의 IXpsRasterizer 인터페이스에 대한 포인터를 쓰는 위치를 가리킵니다. 메서드가 실패하면 이 위치에 NULL 을 쓰고 오류 코드를 반환합니다.

반환 값

CreateRasterizer 는 호출이 성공하면 S_OK 반환합니다. 그렇지 않으면 메서드는 오류 코드를 반환합니다.

가능한 오류 반환 값은 다음과 같습니다.

반환 코드	설명
E_POINTER	매개 변수 xpsPage 또는 ppIXPSRasterizer가 NULL임
E_INVALIDARG	nonTextRenderingMode 또는 textRenderingMode 매개 변수는 유효한 XPSRAS_RENDERING_MODE 열거형 값이 아닙니다.
E_OUTOFMEMORY	메모리 부족

설명

이 메서드는 Windows 7 이상에서 지원됩니다.

일반적으로 XPS 파이프라인의 XPSDrv 필터는 이 메서드를 호출하여 XPS 래스터라이저를 가져옵니다. 그런 다음 래스터라이저를 사용하여 xpsPage 매개 변수가 가리키는 개체로 캡슐화된 XPS 고정 페이지를 래스터화합니다.

매개 변수 DPI 는 가로 및 세로 차원 모두에서 동일한 것으로 간주되는 프린터 해상도를 지정합니다. IXpsOMPage::GetPageDimensions 메서드에서 가져올 수 있는 XPS 고정 페이지의 너비와 높이는 1/96인치 단위로 표현됩니다. 이러한 너비와 높이 값을 DPI/96으로 곱하여 래스터화된 페이지의 너비와 높이를 픽셀 단위로 결정합니다. IXpsOMPage::GetPageDimensions에 대한 자세한 내용은 IXpsOMPage를 참조하세요. XPS 래스터라이저 개체가 DPI 값을 사용하는 방법에 대한 자세한 내용은 IXpsRasterizer::RasterizeRect를 참조하세요.

성공하면 메서드는 XPS 래스터라이저 개체를 만들고 호출자에게 개체의 IXpsRasterizer 인터페이스에 대한 계산된 참조를 전달합니다. 개체가 더 이상 필요하지 않은 경우 호출자는 개체의 IXpsRasterizer 인터페이스에서 Release 메서드를 호출하여 개체를 해제할 책임이 있습니다.

메서드가 실패하고 ppIXPSRasterizer 가 NULL이 아닌 경우 메서드는 *ppIXPSRasterizer = NULL을 설정합니다.

CreateRasterizer 메서드를 호출하는 코드 예제는 WDK의 XPSRasFilter 샘플을 참조하세요. 이 샘플은 WDK 설치의 Src\Print\Xpsrasfilter 폴더에 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 운영 체제의 Windows 7 이상 버전에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	xpsrassvc.h

추가 정보

IXpsRasterizationFactory

IXpsRasterizer

IXpsRasterizer::RasterizeRect

XPSRAS_RENDERING_MODE