Méthode IPrintOemUni3 ::SetBandSize (prcomoem.h)

Article
02/26/2024

La IPrintOemUni3::SetBandSize méthode peut être utilisée avec les imprimantes prises en charge par Unidrv pour spécifier la taille de bande souhaitée sur la sortie imprimée.

Syntaxe

HRESULT SetBandSize(
  [in] PDEVOBJ pdevobj,
  [in] INT     iFormat,
  [in] DWORD   dwPageWidthBytes,
  [in] DWORD   dwPageHeight,
  [in] DWORD   dwMaxHeight,
  [in] PDWORD  pdwRequiredHeight
);

Paramètres

[in] pdevobj

Pointeur fourni par l’appelant vers une structure DEVOBJ .

[in] iFormat

Valeur entière qui spécifie le format de l’image bitmap en termes de nombre de bits d’informations de couleur par pixel requis. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
BMF_1BPP	Monochrome
BMF_4BPP	4 bits par pixel
BMF_8BPP	8 bits par pixel
BMF_16BPP	16 bits par pixel
BMF_24BPP	24 bits par pixel
BMF_32BPP	32 bits par pixel
BMF_4RLE	4 bits par pixel ; longueur d’exécution encodée
BMF_8RLE	8 bits par pixel ; longueur d’exécution encodée

[in] dwPageWidthBytes

Valeur unidrv fournie qui spécifie la largeur de la zone d’impression, en octets.

[in] dwPageHeight

Valeur unidrv fournie qui spécifie la hauteur de la zone d’impression, en pixels.

[in] dwMaxHeight

Valeur unidrv fournie qui spécifie la hauteur maximale autorisée de la zone d’impression, en pixels.

[in] pdwRequiredHeight

Pointeur fourni par l’appelant vers un DWORD qui contient la hauteur de la zone d’impression, en pixels, requise par le plug-in de rendu.

Valeur retournée

La méthode doit retourner l’une des valeurs suivantes :

Code de retour	Description
S_OK	L’opération a réussi. Consultez Remarque.
E_FAIL	L'opération a échoué. Consultez Remarque.
E_NOTIMPL	Unidrv doit calculer la taille de la bande.

Remarques

Cette méthode est disponible dans Windows Vista et versions ultérieures.

Cette méthode est utilisée par un plug-in de rendu pour spécifier la taille de la bande à l’aide des propres calculs du plug-in, plutôt que des calculs de taille de bande d’Unidrv.

Vous pouvez désactiver les opérations de bande par Unidrv en définissant la valeur dwPageHeight sur *pdwRequiredHeight, mais vous devez tenir compte de l’effet sur les performances de la valeur de hauteur que le plug-in de rendu demande. Pour le rendu, Unidrv a besoin d’au moins la quantité de mémoire calculée en multipliant dwPageWidthBytes par *pdwRequiredHeight. Si le plug-in de rendu prend en charge la méthode IPrintOemUni ::D riverDMS et que cette méthode retourne « S_OK », IPrintOemUni3::SetBandSize n’est pas appelée.

Si cette méthode est définie et que le fichier de description d’imprimante générique (GPD) de l’imprimante indique que la préanalyse est désactivée (le fichier GPD inclut « *PreAnalysisOptions : 0 »), Unidrv appelle cette méthode pour calculer la taille de la bande. Pour plus d’informations sur l’attribut PreAnalysisOptions , consultez Infrastructure de préanalysis.

Si le plug-in de rendu prend en charge IPrintOemUni ::D riverDMS et que cette méthode retourne S_OK, IPrintOemUni3::SetBandSize n’est pas appelée.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	prcomoem.h (inclure Prcomoem.h)

Partager via