Méthode IXpsRasterizationFactory ::CreateRasterizer (xpsrassvc.h)

Article
03/01/2024

La méthode CreateRasterize crée un objet rastériseur XPS.

Syntaxe

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

Paramètres

[in, optional] xpsPage

Pointeur vers un objet IXpsOMPage qui représente la page fixe XPS à afficher. Cet objet encapsule une section FixedPage à partir d’un document XPS. Pour plus d’informations, consultez IXpsOMPage.

[in] DPI

Points par pouce dans la sortie rastérisée. Ce paramètre s’applique aux dimensions x et y de la bitmap de sortie. La valeur PPP est la résolution de l’appareil qui doit imprimer ou afficher la page fixe XPS.

[in] nonTextRenderingMode

Mode de rendu pour les éléments non texte dans la sortie rastérisée. Ce paramètre indique s’il faut générer une sortie anticrénelée. Définissez ce paramètre sur l’une des valeurs d’énumération XPSRAS_RENDERING_MODE suivantes :

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Mode de rendu du texte dans la sortie rastérisée. Ce paramètre indique s’il faut générer une sortie anticrénelée. Définissez ce paramètre sur l’une des valeurs d’énumération XPSRAS_RENDERING_MODE suivantes :

XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED

[out, optional] ppIXPSRasterizer

Ce paramètre pointe vers un emplacement dans lequel la méthode écrit un pointeur vers l’interface IXpsRasterizer de l’objet rastériseur XPS nouvellement créé. Si la méthode échoue, elle écrit NULL à cet emplacement et retourne un code d’erreur.

Valeur retournée

CreateRasterizer retourne S_OK si l’appel a réussi. Sinon, la méthode retourne un code d'erreur.

Les valeurs de retour d’erreur possibles sont les suivantes :

Code de retour	Description
E_POINTER	Le paramètre xpsPage ou ppIXPSRasterizer est NULL
E_INVALIDARG	Le paramètre nonTextRenderingMode ou textRenderingMode n’est pas une valeur d’énumération XPSRAS_RENDERING_MODE valide.
E_OUTOFMEMORY	Mémoire insuffisante

Remarques

Cette méthode est prise en charge dans Windows 7 et versions ultérieures.

En règle générale, un filtre XPSDrv dans un pipeline XPS appelle cette méthode pour obtenir un rastériseur XPS. Il utilise ensuite le rastériseur pour rastériser la page fixe XPS encapsulée par l’objet vers lequel pointe le paramètre xpsPage .

Le paramètre PPP spécifie la résolution de l’imprimante, qui est supposée être la même dans les dimensions horizontale et verticale. La largeur et la hauteur de la page fixe XPS, qui peuvent être obtenues à partir de la méthode IXpsOMPage ::GetPageDimensions , sont exprimées en unités de 1/96 pouce. Multipliez ces valeurs de largeur et de hauteur par PPP/96 pour déterminer la largeur et la hauteur, en pixels, de la page rastérisée. Pour plus d’informations sur IXpsOMPage ::GetPageDimensions, consultez IXpsOMPage. Pour plus d’informations sur la façon dont l’objet rastériseur XPS utilise la valeur PPP, consultez IXpsRasterizer ::RasterizeRect.

Si elle réussit, la méthode crée un objet rastériseur XPS et transmet à l’appelant une référence comptabilisée à l’interface IXpsRasterizer de l’objet. Lorsque l’objet n’est plus nécessaire, l’appelant est chargé de libérer l’objet en appelant la méthode Release sur l’interface IXpsRasterizer de l’objet.

Si la méthode échoue et que ppIXPSRasterizer n’a pas la valeur NULL, la méthode définit *ppIXPSRasterizer = NULL.

Pour obtenir un exemple de code qui appelle la méthode CreateRasterizer , consultez l’exemple XPSRasFilter dans wdK. Cet exemple se trouve dans le dossier Src\Print\Xpsrasfilter de votre installation WDK.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 7 et versions ultérieures du système d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	xpsrassvc.h

Voir aussi

IXpsRasterizationFactory

IXpsRasterizer

IXpsRasterizer ::RasterizeRect

XPSRAS_RENDERING_MODE

Share via