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

Article
02/07/2025

La méthode IPrintOemUni3::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_GRAPHICS_RESOLUTION_TYPE	Ajustez le paramètre de résolution graphique signalé dans la structure PDEV. Pour plus d’informations, consultez la structure PDEV_ADJUST_GRAPHICS RESOLUTION.
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Ajustez la zone d’origine imageable signalée dans la structure PDEV. Pour plus d’informations, consultez la structure PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA.
PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE	Ajustez le format de papier physique signalé dans la structure PDEV. Pour plus d’informations, consultez la structure PDEV_ADJUST_PAPER_PHYSICAL_SIZE.

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 IPrintOemUni3::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 Vista et versions ultérieures.

Actuellement, le pilote Unidrv appelle IPrintOemUni3::GetPDEVAdjustment pour ajuster le paramètre de résolution graphique, comme indiqué dans le PDEV, pour ajuster la zone d’origine imageable ou pour ajuster la taille du papier physique.