Fonction DrvQueryPerBandInfo (winddi.h)
La fonction DrvQueryPerBandInfo d’une DLL de graphiques d’imprimante est appelée par GDI avant de commencer à dessiner une bande pour une page physique, afin que le pilote puisse fournir à GDI des informations spécifiques à la bande.
Syntaxe
ULONG DrvQueryPerBandInfo(
[in] SURFOBJ *pso,
[in, out] PERBANDINFO *pbi
);
Paramètres
[in] pso
Pointeur fourni par l’appelant vers une structure SURFOBJ décrivant la surface de dessin.
[in, out] pbi
Pointeur fourni par l’appelant vers une structure PERBANDINFO contenant des informations par défaut, que la fonction peut remplacer.
Valeur retournée
La fonction doit retourner l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
|
GDI utilise le contenu de la structure PERBANDINFO. |
|
GDI ignore le contenu de la structure PERBANDINFO. |
|
GDI ne dessine pas la bande. |
Remarques
Si une DLL graphique d’imprimante utilise des surfaces gérées par GDI et qu’elle prend en charge la bande de surface, elle peut éventuellement fournir une fonction DrvQueryPerBandInfo . GDI appelle la fonction avant le rendu de chaque bande.
La DLL de graphiques d’imprimante utilise la structure PERBANDINFO de la fonction pour indiquer si la bande précédente doit être redessinée et pour spécifier que la bande doit être mise à l’échelle. Si une DLL graphique d’imprimante prend en charge la bande mais ne fournit pas de fonction DrvQueryPerBandInfo , GDI ne se répète pas ou ne met pas à l’échelle les bandes.
La fonction DrvQueryPerBandInfo n’est appelée que pendant la lecture de fichiers EMF.
Configuration requise
| Plateforme cible | Bureau |
| En-tête | winddi.h (inclure Winddi.h) |