Méthode IPrintOemUni3 ::SetBandSize (prcomoem.h)
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.
[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 |
---|---|
|
L’opération a réussi. Consultez Remarque. |
|
L'opération a échoué. Consultez Remarque. |
|
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) |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour