IXpsRasterizationFactory::CreateRasterizer-Methode (xpsrassvc.h)
Die CreateRasterize-Methode erstellt ein XPS-Rasterizer-Objekt.
Syntax
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
Zeiger auf ein IXpsOMPage-Objekt , das die zu rendernde XPS-Feste Seite darstellt. Dieses Objekt kapselt einen FixedPage-Abschnitt aus einem XPS-Dokument. Weitere Informationen finden Sie unter IXpsOMPage.
[in] DPI
Punkte pro Zoll in der gerasterten Ausgabe. Dieser Parameter gilt für die x- und y-Dimensionen der Ausgabebitbitbit. Der DPI-Wert ist die Auflösung des Geräts, das die XPS-Feste Seite drucken oder anzeigen soll.
[in] nonTextRenderingMode
Renderingmodus für Nichttextelemente in der gerasterten Ausgabe. Dieser Parameter gibt an, ob eine Antialiased-Ausgabe generiert werden soll. Legen Sie diesen Parameter auf einen der folgenden XPSRAS_RENDERING_MODE Enumerationswerte fest:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[in] textRenderingMode
Renderingmodus für Text in der gerasterten Ausgabe. Dieser Parameter gibt an, ob eine Antialiased-Ausgabe generiert werden soll. Legen Sie diesen Parameter auf einen der folgenden XPSRAS_RENDERING_MODE Enumerationswerte fest:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[out, optional] ppIXPSRasterizer
Dieser Parameter verweist auf eine Position, an der die -Methode einen Zeiger auf die IXpsRasterizer-Schnittstelle des neu erstellten XPS-Rasterizer-Objekts schreibt. Wenn die Methode fehlschlägt, schreibt sie NULL an diesen Speicherort und gibt einen Fehlercode zurück.
Rückgabewert
CreateRasterizer gibt S_OK zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen Fehlercode zurück.
Mögliche Fehlerrückgabewerte sind:
| Rückgabecode | Beschreibung |
|---|---|
| E_POINTER | Der Parameter xpsPage oder ppIXPSRasterizer ist NULL. |
| E_INVALIDARG | Parameter nonTextRenderingMode oder textRenderingMode ist kein gültiger XPSRAS_RENDERING_MODE Enumerationswert. |
| E_OUTOFMEMORY | Nicht genügend Arbeitsspeicher. |
Hinweise
Diese Methode wird in Windows 7 und höher unterstützt.
In der Regel ruft ein XPSDrv-Filter in einer XPS-Pipeline diese Methode auf, um einen XPS-Rasterizer abzurufen. Anschließend wird der Rasterizer verwendet, um die xpS-Feste Seite zu rastern, die von dem Objekt gekapselt ist, auf das der Parameter xpsPage verweist.
Der Parameter DPI gibt die Druckerauflösung an, die sowohl in den horizontalen als auch in der vertikalen Dimension gleich ist. Die Breite und Höhe der festen XPS-Seite, die von der IXpsOMPage::GetPageDimensions-Methode abgerufen werden kann, werden in 1/96-Zoll-Einheiten ausgedrückt. Multiplizieren Sie diese Breiten- und Höhenwerte mit DPI/96, um die Breite und Höhe der gerasterten Seite in Pixel zu bestimmen. Weitere Informationen zu IXpsOMPage::GetPageDimensions finden Sie unter IXpsOMPage. Weitere Informationen dazu, wie das XPS-Rasterizer-Objekt den DPI-Wert verwendet, finden Sie unter IXpsRasterizer::RasterizeRect.
Bei erfolgreicher Ausführung erstellt die Methode ein XPS-Rasterizer-Objekt und übergibt an den Aufrufer einen gezählten Verweis auf die IXpsRasterizer-Schnittstelle des Objekts. Wenn das Objekt nicht mehr benötigt wird, ist der Aufrufer für das Freigeben des Objekts verantwortlich, indem er die Release-Methode auf der IXpsRasterizer-Schnittstelle des Objekts aufruft.
Wenn die Methode fehlschlägt und ppIXPSRasterizer nicht NULL ist, legt die Methode *ppIXPSRasterizer = NULL fest.
Ein Codebeispiel, das die CreateRasterizer-Methode aufruft, finden Sie im XPSRasFilter-Beispiel im WDK. Dieses Beispiel befindet sich im Ordner Src\Print\Xpsrasfilter in Ihrer WDK-Installation.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform | Desktop |
| Kopfzeile | xpsrassvc.h |