IXpsRasterizationFactory2：：CreateRasterizer 方法 (xpsrassvc.h)
CreateRasterizer 方法创建一个 XPS 光栅器对象，该对象可以使用 XPS 光栅化服务将内容从 XPS 转换为 PWG 光栅。 PWG 光栅支持非矩形 DPI。
语法
HRESULT CreateRasterizer(
[in, optional] IXpsOMPage *xpsPage,
[in] FLOAT DPIX,
[in] FLOAT DPIY,
[in] XPSRAS_RENDERING_MODE nonTextRenderingMode,
[in] XPSRAS_RENDERING_MODE textRenderingMode,
[in] XPSRAS_PIXEL_FORMAT pixelFormat,
[in] XPSRAS_BACKGROUND_COLOR backgroundColor,
[out, optional] IXpsRasterizer **ppIXpsRasterizer
);
参数
[in, optional] xpsPage
指向表示要呈现的 XPS 固定页的 IXpsOMPage 对象的指针。 此对象封装 XPS 文档中的 FixedPage 节。
[in] DPIX
应用于光栅化输出位图的 x 维度的每英寸点数。 DPI 值是打印或显示 XPS 固定页的设备分辨率。
[in] DPIY
应用于光栅化输出位图的 y 维度的每英寸点数。
[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
[in] pixelFormat
允许调用方选择 IXpsRasterizer：：RasterizeRect 返回的 IWICBitmap 使用的像素格式。 将此参数设置为以下 XPSRAS_PIXEL_FORMAT 枚举值之一：
XPSRAS_PIXEL_FORMAT_32BPP_PBGRA_UINT_SRGB
XPSRAS_PIXEL_FORMAT_64BPP_PRGBA_HALF_SCRGB
XPSRAS_PIXEL_FORMAT_128BPP_PRGBA_FLOAT_SCRGB
[in] backgroundColor
允许调用方选择背景色。 将此参数设置为以下 XPSRAS_BACKGROUND_COLOR 枚举值之一：
XPSRAS_BACKGROUND_COLOR_TRANSPARENT
XPSRAS_BACKGROUND_COLOR_OPAQUE
默认背景色为XPSRAS_BACKGROUND_COLOR_TRANSPARENT。
[out, optional] ppIXpsRasterizer
此参数指向方法将指针写入到新创建的 XPS 光栅 器对象的 IXpsRasterizer 接口的位置。 如果方法失败，它会将 NULL 写入此位置并返回错误代码。
返回值
如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10 |
| 目标平台 | 桌面 |
| 标头 | xpsrasvc.h (包括 Xpsrassvc.h) |