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
Zeigen Sie 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 rasterisierten Ausgabe. Dieser Parameter gilt sowohl für die x- als auch für die y-Abmessungen der Ausgabebitmap. Der DPI-wert ist die Auflösung des Geräts, das die XPS-feste Seite drucken oder anzeigen soll.
[in] nonTextRenderingMode
Rendermodus für Nichttextelemente in der gerasterten Ausgabe. Dieser Parameter gibt an, ob antialiasierte 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
Rendermodus für Text in der gerasterten Ausgabe. Dieser Parameter gibt an, ob antialiasierte 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, in die die Methode einen Zeiger auf das 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 | Parameter xpsPage oder ppIXPSRasterizer ist NULL- |
| E_INVALIDARG | Parameter nonTextRenderingMode oder textRenderingMode- kein gültiger XPSRAS_RENDERING_MODE Enumerationswert ist. |
| E_OUTOFMEMORY | Nicht genügend Arbeitsspeicher |
Bemerkungen
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 vom Objekt gekapselt wird, auf das der Parameter xpsPage Punkt.
Der Parameter DPI- gibt die Druckerauflösung an, die sowohl in den horizontalen als auch in vertikalen Abmessungen identisch ist. Die Breite und Höhe der festen XPS-Seite, die aus der IXpsOMPage::GetPageDimensions-Methode abgerufen werden kann, werden in 1/96-Zoll-Einheiten ausgedrückt. Multiplizieren Sie diese Werte für Breite und Höhe mit DPI/96, um die Breite und Höhe der gerasterten Seite in Pixeln zu bestimmen. Weitere Informationen zu IXpsOMPage::GetPageDimensionsfinden 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 dafür verantwortlich, das Objekt freizugeben, indem die Release--Methode für die IXpsRasterizer Schnittstelle des Objekts aufgerufen wird.
Wenn die Methode fehlschlägt und ppIXPSRasterizer nichtNULL-ist, legt die Methode *ppIXPSRasterizer = NULL-fest.
Ein Codebeispiel, das die CreateRasterizer--Methode aufruft, finden Sie im XPSRasFilter-Beispiel im WDK.For a code example that calls the CreateRasterizer method, see the XPSRasFilter sample in the WDK. Dieses Beispiel befindet sich im Ordner "Src\Print\Xpsrasfilter" in Ihrer WDK-Installation.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform- | Desktop |
| Header- | xpsrassvc.h |