IPrintOemPS2 ::GetPDEVAdjustment, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemPS2::GetPDEVAdjustment permet à un plug-in de remplacer des paramètres de PDEV spécifiques.

Syntaxe

HRESULT GetPDEVAdjustment(
        PDEVOBJ  pdevobj,
        DWORD    dwAdjustType,
        PVOID    pBuf,
        DWORD    cbBuffer,
  [out] OUT BOOL *pbAdjustmentDone
);

Paramètres

pdevobj

Pointeur vers une structure DEVOBJ.

dwAdjustType

Spécifie le type d’ajustement demandé. Les indicateurs suivants sont actuellement pris en charge :

Drapeau	Signification
PDEV_ADJUST_PAPER_MARGIN_TYPE	Ajustez le paramètre de marge papier signalé dans le PDEV. Consultez la structure PDEV_ADJUST_PAPER_MARGIN.
PDEV_HOSTFONT_ENABLED_TYPE	Activez ou désactivez la fonctionnalité de support Hostfont. Consultez la structure PDEV_HOSTFONT_ENABLED.
PDEV_USE_TRUE_COLOR_TYPE	Activez ou désactivez la sortie de couleur pour les imprimantes monochromes et de couleur. Consultez la structure PDEV_USE_TRUE_COLOR.

pBuf

Pointeur vers une structure qui contient les paramètres planifiés utilisés s’il n’y a aucune modification. Ces structures sont répertoriées dans le tableau précédent. Le plug-in peut remplacer les paramètres de la structure appropriée.

cbBuffer

Spécifie la taille, en octets, de la structure pointée par pBuf.

[out] pbAdjustmentDone

Pointeur vers un emplacement de mémoire que le plug-in définit sur TRUE lorsqu’il modifie réellement une valeur dans la mémoire tampon. Cela peut être utilisé par le pilote pour les optimisations.

Valeur de retour

La méthode IPrintOemPS2::GetPDEVAdjustment doit retourner S_OK si elle reconnaît le type d’ajustement et S_FALSE si ce n’est pas le cas. Si la méthode échoue, elle doit retourner E_FAIL. La chaîne de plug-ins est appelée jusqu’à ce que S_OK ou un code d’échec autre que E_NOTIMPL soit retourné. Autrement dit, la chaîne de plug-ins est appelée jusqu’à ce que le premier plug-in capable de gérer l’ajustement soit trouvé.

Remarques

Cette fonction est disponible dans Windows XP et versions ultérieures.

Actuellement, le pilote Pscript5 appelle IPrintOemPS2::GetPDEVAdjustment pour ajuster le paramètre de marge papier, comme indiqué dans le PDEV, pour activer ou désactiver la fonctionnalité Hostfont, ou pour activer ou désactiver la sortie de couleur PostScript.