Metode IXpsRasterizationFactory::CreateRasterizer (xpsrassvc.h)

Artikel
03/01/2024

Metode CreateRasterize membuat objek rasterizer XPS.

Sintaks

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

Parameter

[in, optional] xpsPage

Penunjuk ke objek IXpsOMPage yang mewakili halaman tetap XPS untuk dirender. Objek ini merangkum bagian FixedPage dari dokumen XPS. Untuk informasi selengkapnya, lihat IXpsOMPage.

[in] DPI

Titik per inci dalam output yang dirasterisasi. Parameter ini berlaku untuk dimensi x dan y dari bitmap output. Nilai DPI adalah resolusi perangkat yang akan mencetak atau menampilkan halaman tetap XPS.

[in] nonTextRenderingMode

Mode penyajian untuk item nonteks dalam output yang dirasterisasi. Parameter ini menunjukkan apakah akan menghasilkan output yang diantisipasi. Atur parameter ini ke salah satu nilai enumerasi XPSRAS_RENDERING_MODE berikut:

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Mode penyajian untuk teks dalam output yang dirasterisasi. Parameter ini menunjukkan apakah akan menghasilkan output yang diantisipasi. Atur parameter ini ke salah satu nilai enumerasi XPSRAS_RENDERING_MODE berikut:

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[out, optional] ppIXPSRasterizer

Parameter ini menunjuk ke lokasi di mana metode menulis pointer ke antarmuka IXpsRasterizer dari objek rasterizer XPS yang baru dibuat. Jika metode gagal, metode menulis NULL ke lokasi ini dan mengembalikan kode kesalahan.

Nilai kembali

CreateRasterizer mengembalikan S_OK jika panggilan berhasil. Jika tidak, metode mengembalikan kode kesalahan.

Kemungkinan nilai pengembalian kesalahan meliputi:

Menampilkan kode	Deskripsi
E_POINTER	Parameter xpsPage atau ppIXPSRasterizer adalah NULL
E_INVALIDARG	Parameter nonTextRenderingMode atau textRenderingMode bukan nilai enumerasi XPSRAS_RENDERING_MODE yang valid.
E_OUTOFMEMORY	Kehabisan memori

Keterangan

Metode ini didukung di Windows 7 dan yang lebih baru.

Biasanya, filter XPSDrv dalam alur XPS memanggil metode ini untuk mendapatkan rasterizer XPS. Kemudian menggunakan rasterizer untuk mem-rasterisasi halaman tetap XPS yang dienkapsulasi oleh objek tempat parameter xpsPage menunjuk.

Parameter DPI menentukan resolusi printer, yang diasumsikan sama dalam dimensi horizontal dan vertikal. Lebar dan tinggi halaman tetap XPS, yang dapat diperoleh dari metode IXpsOMPage::GetPageDimensions , dinyatakan dalam unit 1/96 inci. Kalikan nilai lebar dan tinggi ini dengan DPI/96 untuk menentukan lebar dan tinggi, dalam piksel, dari halaman yang diraster. Untuk informasi selengkapnya tentang IXpsOMPage::GetPageDimensions, lihat IXpsOMPage. Untuk informasi selengkapnya tentang bagaimana objek rasterizer XPS menggunakan nilai DPI, lihat IXpsRasterizer::RasterizeRect.

Jika berhasil, metode membuat objek rasterizer XPS dan meneruskan ke pemanggil referensi terhitung ke antarmuka IXpsRasterizer objek. Ketika objek tidak lagi diperlukan, pemanggil bertanggung jawab untuk merilis objek dengan memanggil metode Rilis pada antarmuka IXpsRasterizer objek.

Jika metode gagal dan ppIXPSRasterizernon-NULL, metode menetapkan *ppIXPSRasterizer = NULL.

Untuk contoh kode yang memanggil metode CreateRasterizer , lihat sampel XPSRasFilter di WDK. Sampel ini terletak di folder Src\Print\Xpsrasfilter di penginstalan WDK Anda.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	xpsrassvc.h

Lihat juga

IXpsRasterizationFactory

IXpsRasterizer

IXpsRasterizer::RasterizeRect

XPSRAS_RENDERING_MODE

Share via