Attributs réservés au niveau de la racine
Important
La plateforme d’impression moderne est le moyen privilégié de Windows pour communiquer avec les imprimantes. Nous vous recommandons d’utiliser le pilote de classe IPP en boîte de Microsoft, ainsi que les applications de support d’impression (PSA), pour personnaliser l’expérience d’impression dans Windows 10 et 11 pour le développement de périphériques d’impression.
Pour plus d’informations, veuillez consulter la section Plateforme d’impression moderne et le Guide de conception des applications de support d’impression.
Les attributs de niveau racine uniquement sont des attributs généraux qui décrivent des caractéristiques propres au pilote telles que les noms des fichiers de ressources, des fichiers d'aide ou des fichiers GPD supplémentaires inclus, ainsi que les spécifications relatives aux unités maîtres, au numéro de version et à la page de code de caractères du pilote.
Des attributs supplémentaires réservés au niveau racine spécifient des caractéristiques propres à l'appareil, telles que le nom de l'imprimante, son type, sa capacité de copie maximale et le nombre d'emplacements pour les cartouches de polices.
Ces attributs sont appelés attributs au niveau de la racine uniquement car ils doivent toujours être placés dans un fichier GPD au niveau de la racine (c'est-à-dire pas entre accolades).
Le tableau suivant répertorie les attributs réservés à la racine.
| Nom de l’attribut | AttributeParameter | Commentaires |
|---|---|---|
| CodePage | Identifiant de page de code Windows à valeur numérique. | facultatif. S'il n'est pas spécifié, Unicode est utilisé. La page de code est appliquée à toutes les chaînes affichées. |
| FontCartSlots | Valeur numérique représentant le nombre d'emplacements de cartouches de polices fournis par l'imprimante. | facultatif. Si cette valeur n’est pas spécifiée, la valeur par défaut est zéro. |
| GPDFileName | Chaîne de texte entre guillemets représentant le nom du fichier GPD (sans chemin d'accès). | facultatif. |
| GPDFileVersion | Chaîne de texte entre guillemets représentant la version actuelle du fichier GPD. Le format recommandé est MajorVersion.MinorVersion, par exemple « 1.0 ». | facultatif. Si elle est spécifiée, cette chaîne est affichée dans la boîte de dialogue A propos de Unidrv. |
| GPDSpecVersion | Chaîne de texte entre guillemets représentant la version actuelle de la spécification GPD. Le format requis est MajorVersion.MinorVersion, par exemple « 1.0 ». | Obligatoire. Doit être la première entrée du fichier GPD, avant tout commentaire. Cette valeur doit être « 1.0 » pour Windows 2000. |
| HelpFile | Chaîne entre guillemets contenant le nom d'un fichier d'aide personnalisé, avec une extension .hlp. | facultatif. S'il est inclus, il peut ajouter des rubriques ou remplacer des rubriques existantes dans le fichier d'aide d'Unidrv. Les index des fichiers d'aide sont spécifiés par les attributs *HelpIndex pour les fonctionnalités et les options. |
| Inclure | Chaîne entre guillemets contenant le nom d'un fichier GPD supplémentaire. | Obsolète. Cette entrée a été redéfinie comme une directive du préprocesseur. |
| InstalledOptionName | Chaîne entre guillemets affichée pour indiquer qu'une fonctionnalité ou une option installable est installée. En règle générale, cette chaîne est « Installé », mais toute autre chaîne appropriée peut être spécifiée. | Requis si *Installable? est VRAI pour toutes les fonctionnalités ou options (voir Attributs des fonctionnalités), et si rcInstalledOptionNameID n'est pas spécifié. |
| MasterUnits | PAIR représentant les unités maîtresses de l'imprimante. | Obligatoire. Pour réduire les erreurs d'arrondi potentielles, utilisez les mêmes valeurs pour les unités de résolution dans les données de métriques de police que celles que vous spécifiez pour MasterUnits. (Voir Unidrv Font Metrics dans Gestion personnalisée des polices). |
| MaxCopies | Valeur numérique représentant le nombre maximum de copies que l'imprimante peut prendre en charge. | facultatif. Si elle n’est pas spécifiée, la valeur par défaut est 1. |
| ModelName | Chaîne de texte entre guillemets représentant le nom du modèle de l'imprimante. | Requis si rcModelNameID n'est pas spécifié. La chaîne doit correspondre au nom figurant dans le fichier setup.inf. |
| NotInstalledOptionName | Chaîne entre guillemets affichée pour indiquer qu'une fonctionnalité ou une option installable n'est pas installée. En règle générale, cette chaîne est « Non installé », mais toute autre chaîne appropriée peut être spécifiée. | Requis si Installable ? est TRUE pour toutes les fonctionnalités ou options (voir Attributs des fonctionnalités), et si rcNotInstalledOptionNameID n'est pas spécifié. |
| Personnalité | Chaîne entre guillemets représentant le langage d'impression utilisé par l'imprimante. | facultatif. Si elle est spécifiée, la chaîne est affichée par les services d'annuaire. Voir également rcPersonalityID plus bas dans ce tableau. |
| PrinterType | PAGE, SERIAL ou TTY | Requis |
| PrintRate | Valeur numérique représentant la vitesse d'impression monochrome. Les unités sont spécifiées par PrintRateUnit. | facultatif. Si elle n’est pas spécifiée, la valeur par défaut est 0. |
| PrintRatePPM | Valeur numérique représentant la vitesse d'impression, en pages par minute. | facultatif. Si elle n’est pas spécifiée, la valeur par défaut est 0. |
| PrintRateUnit | PPM - Pages/min CPS - Caractères/sec LPM - Lignes/min IPM - Pouces/min. (IPM pour les traceurs) |
Requis si PrintRate est spécifié. L'unité spécifiée doit correspondre au type d'imprimante. Par exemple, PPM doit être spécifié pour les imprimantes à pages. |
| rcInstalledOptionNameID | ID de ressource d'une ressource de type chaîne qui est affichée pour indiquer qu'une fonctionnalité ou une option installable est installée. En règle générale, cette chaîne est « Installé », mais toute autre chaîne appropriée peut être spécifiée. | Requis si Installable? est VRAI pour toutes les fonctionnalités ou options (voir Attributs des fonctionnalités), et si InstalledOptionName n'est pas spécifié. |
| rcNotInstalledOptionNameID | ID d'une ressource sous forme de chaîne qui est affichée pour indiquer qu'une fonctionnalité ou une option installable n'est pas installée. En règle générale, cette chaîne est « Non installé », mais toute autre chaîne appropriée peut être spécifiée. | Requis si Installable? est VRAI pour toutes les fonctionnalités ou options (voir Attributs des fonctionnalités), et si NotInstalledOptionName n'est pas spécifié. |
| rcPersonalityID | ID de ressource d'une ressource de type chaîne représentant le langage d'impression utilisé par l'imprimante. | facultatif. Si elle est spécifiée, la chaîne est affichée par les services d'annuaire. Voir aussi Personnalité. |
| rcPrinterIconID | ID d'une ressource RC_ICON représentant une icône associée à l'imprimante. | facultatif. Si elle n'est pas spécifiée, une icône d'imprimante par défaut est affichée. Il est recommandé de numéroter toutes les ressources RC_ICON de manière contiguë en commençant par 1. |
| ResourceDLL | Chaîne entre guillemets contenant le nom, sans informations sur le chemin d'accès, d'une DLL de ressource. | facultatif. Voir Utilisation de DLL de ressources dans un minipilote. |
Pour plus d'informations sur les nouveaux attributs root-level-only pour Windows Vista, voir Nouveaux attributs GPD root-level-only pour Windows Vista et Nouveaux attributs PPD root-level-only pour Windows Vista.