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 con suavizado de contorno. Establezca este parámetro en uno de los siguientes XPSRAS_RENDERING_MODE valores de enumeración:
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 con suavizado de contorno. 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 a la interfaz IXpsRasterizer 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:
| 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 | No hay memoria suficiente |
Comentarios
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 del método IXpsOMPage::GetPageDimensions , se expresan en unidades de 1/96 pulgadas. Multiplique estos valores de ancho y alto por PPP/96 para determinar el ancho y 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 de 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 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 en la interfaz IXpsRasterizer del objeto.
Si se produce un error en el método y ppIXPSRasterizer no es NULL, 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 | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores del sistema operativo Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | xpsrassvc.h |