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 |