Método IXpsRasterizationFactory::CreateRasterizer (xpsrassvc.h)
El método CreateRasterize crea un objeto rasterizador XPS.
Sintaxis
HRESULT CreateRasterizer(
[in, optional] IXpsOMPage *xpsPage,
[in] FLOAT DPI,
[in] XPSRAS_RENDERING_MODE nonTextRenderingMode,
[in] XPSRAS_RENDERING_MODE textRenderingMode,
[out, optional] IXpsRasterizer **ppIXPSRasterizer
);
Parámetros
[in, optional] xpsPage
Puntero a un objeto IXpsOMPage que representa la página fija XPS que se va a representar. Este objeto encapsula una sección FixedPage de un documento XPS. Para obtener más información, vea IXpsOMPage .
[in] DPI
Puntos por pulgada en la salida rasterizada. Este parámetro se aplica a las dimensiones x e y del mapa de bits de salida. El valor de PPP es la resolución del dispositivo que se va a imprimir o mostrar la página fija XPS.
[in] nonTextRenderingMode
Modo de representación para elementos que no son de texto en la salida rasterizada. Este parámetro indica si se va a generar una salida antialiased. Establezca este parámetro en uno de los siguientes valores de enumeración XPSRAS_RENDERING_MODE:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[in] textRenderingMode
Modo de representación para texto en la salida rasterizada. Este parámetro indica si se va a generar una salida antialiased. Establezca este parámetro en uno de los siguientes valores de enumeración XPSRAS_RENDERING_MODE:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[out, optional] ppIXPSRasterizer
Este parámetro apunta a una ubicación en la que el método escribe un puntero al IXpsRasterizer interfaz del objeto rasterizador XPS recién creado. Si se produce un error en el método, escribe NULL en esta ubicación y devuelve un código de error.
Valor devuelto
createRasterizer devuelve S_OK si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error.
Entre los posibles valores devueltos de error se incluyen los siguientes:
| Código devuelto | Descripción |
|---|---|
| E_POINTER | El parámetro xpsPage o ppIXPSRasterizer es NULL |
| E_INVALIDARG | El parámetro nonTextRenderingMode o textRenderingMode no es un valor de enumeración XPSRAS_RENDERING_MODE válido. |
| E_OUTOFMEMORY | Memoria insuficiente |
Observaciones
Este método se admite en Windows 7 y versiones posteriores.
Normalmente, un filtro XPSDrv en una canalización XPS llama a este método para obtener un rasterizador XPS. A continuación, usa el rasterizador para rasterizar la página fija XPS encapsulada por el objeto al que apunta el parámetro xpsPage.
El parámetro PPP especifica la resolución de impresora, que se supone que es la misma en las dimensiones horizontales y verticales. El ancho y alto de la página fija XPS, que se puede obtener de la IXpsOMPage::GetPageDimensions método, se expresan en unidades de 1/96 pulgadas. Multiplique estos valores de ancho y alto por PPP/96 para determinar el ancho y el alto, en píxeles, de la página rasterizada. Para obtener más información sobre IXpsOMPage::GetPageDimensions, vea IXpsOMPage. Para obtener más información sobre cómo el objeto rasterizador XPS usa el valor de PPP, vea IXpsRasterizer::RasterizeRect.
Si se ejecuta correctamente, el método crea un objeto rasterizador XPS y pasa al autor de la llamada una referencia contada a la interfaz de IXpsRasterizer del objeto. Cuando el objeto ya no es necesario, el autor de la llamada es responsable de liberar el objeto llamando al método release del objeto en la interfaz IXpsRasterizer del objeto.
Si se produce un error en el método y ppIXPSRasterizer no esNULL, el método establece *ppIXPSRasterizer = null.
Para obtener un ejemplo de código que llama al método CreateRasterizer, vea el ejemplo XPSRasFilter en WDK. Este ejemplo se encuentra en la carpeta Src\Print\Xpsrasfilter de la instalación de WDK.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 7 y versiones posteriores del sistema operativo Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | xpsrassvc.h |