Méthode IPrintOemPS2 ::GetPDEVAdjustment (prcomoem.h)

Article
02/29/2024

La IPrintOemPS2::GetPDEVAdjustment méthode permet à un plug-in de remplacer des paramètres 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 :

Indicateur	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 prise en charge d’Hostfont. Consultez la structure PDEV_HOSTFONT_ENABLED .
PDEV_USE_TRUE_COLOR_TYPE	Activez ou désactivez la sortie couleur pour les imprimantes monochromes et couleur. Consultez la structure PDEV_USE_TRUE_COLOR .

pBuf

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

cbBuffer

Spécifie la taille, en octets, de la structure pointée vers 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. Il peut être utilisé par le pilote pour les optimisations.

Valeur retournée

La IPrintOemPS2::GetPDEVAdjustment méthode 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.