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

Article
02/07/2025

La méthode IPrintOemUni3::SetBandSize peut être utilisée avec des 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 la bitmap en termes de nombre de bits d’informations de couleur par pixel requis. Ce paramètre peut être l’une des 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 non fournie par unidrv qui spécifie la largeur de la zone d’impression, en octets.

[in] dwPageHeight

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

[in] dwMaxHeight

Valeur non fournie par unidrv 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 de retour

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

Retourner le code	Description
S_OK	L’opération a réussi. Voir remarque.
E_FAIL	L’opération a échoué. Voir remarque.
E_NOTIMPL	Unidrv doit calculer la taille de 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 bande à l’aide des propres calculs du plug-in, plutôt que d’utiliser les 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 prendre en compte l’effet de performance de la valeur de hauteur que les demandes de plug-in de rendu. Pour le rendu, Unidrv a besoin au moins de 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 bande. Pour plus d’informations sur l’attribut PreAnalysisOptions, consultez 'infrastructure preanalysis.

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.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	prcomoem.h (include Prcomoem.h)

Partager via