IXpsRasterizationFactory2：：CreateRasterizer 方法 （xpsrassvc.h）
CreateRasterizer 方法會建立 XPS 轉譯器物件，該物件可以使用 XPS 點陣化服務，將內容從 XPS 轉換成 PWG 點陣。 PWG 點陣支援非方形的 DPIs。
語法
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
IXpsOMPage 物件的指標，代表要轉譯的 XPS 固定頁面。 此物件會封裝 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 |
| 目標平臺 | 桌面 |
| 標頭 | xpsrassvc.h （包括 Xpsrassvc.h） |