structure DRIVER_INFO_8A (winspool.h)
La structure DRIVER_INFO_8 contient des informations sur le pilote d’imprimante.
Syntaxe
typedef struct _DRIVER_INFO_8A {
DWORD cVersion;
LPSTR pName;
LPSTR pEnvironment;
LPSTR pDriverPath;
LPSTR pDataFile;
LPSTR pConfigFile;
LPSTR pHelpFile;
LPSTR pDependentFiles;
LPSTR pMonitorName;
LPSTR pDefaultDataType;
LPSTR pszzPreviousNames;
FILETIME ftDriverDate;
DWORDLONG dwlDriverVersion;
LPSTR pszMfgName;
LPSTR pszOEMUrl;
LPSTR pszHardwareID;
LPSTR pszProvider;
LPSTR pszPrintProcessor;
LPSTR pszVendorSetup;
LPSTR pszzColorProfiles;
LPSTR pszInfPath;
DWORD dwPrinterDriverAttributes;
LPSTR pszzCoreDriverDependencies;
FILETIME ftMinInboxDriverVerDate;
DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8A, *PDRIVER_INFO_8A, *LPDRIVER_INFO_8A;
Membres
cVersion
Ce membre spécifie la version du système d’exploitation pour laquelle le pilote a été écrit. Actuellement, il peut s’agir des éléments suivants.
| Valeur | Signification |
|---|---|
| 3 | Pilote pour Microsoft Windows 2000, XP ou Windows Vista. |
pName
Pointeur vers une chaîne terminée par null qui spécifie le nom du pilote (par exemple, QMS 810).
pEnvironment
Pointeur vers une chaîne terminée par null qui spécifie l’environnement pour lequel le pilote a été écrit (par exemple, Microsoft Windows 7, 8 ou Windows Server 2012).
pDriverPath
Pointeur vers une chaîne terminée par null qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour le fichier qui contient le pilote de périphérique (par exemple, C:\DRIVERS\Pscript.dll).
pDataFile
Pointeur vers une chaîne terminée par null qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour le fichier qui contient des données de pilote (par exemple, C :\DRIVERS\Qms810.ppd).
pConfigFile
Pointeur vers une chaîne terminée par null qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour la bibliothèque de liens dynamiques de configuration du pilote de périphérique (par exemple, C:\DRIVERS\Pscrptui.dll).
pHelpFile
Pointeur vers une chaîne terminée par null qui spécifie un nom de fichier ou un chemin d’accès complet et un nom de fichier pour le fichier d’aide du pilote de périphérique (par exemple, C :\DRIVERS\Pscrptui.hlp).
pDependentFiles
Pointeur vers une chaîne Multi-SZ qui contient les noms des fichiers dont dépend le pilote. Les noms de fichiers sont stockés sous la forme d’une série contiguë de chaînes sans fin suivies d’une chaîne vide. Par exemple, Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0, où \0 représente le caractère null de fin.
pMonitorName
Pointeur vers une chaîne terminée par null qui spécifie un moniteur de langage (par exemple, « moniteur PJL »). Ce membre peut être NULL et doit être spécifié uniquement pour les imprimantes capables de communication bidirectionnelle.
pDefaultDataType
Pointeur vers une chaîne terminée par null qui spécifie le type de données par défaut du travail d’impression (par exemple, « EMF »).
pszzPreviousNames
Pointeur vers une chaîne terminée par null qui spécifie tous les noms de pilotes d’imprimante précédents compatibles avec ce pilote (par exemple, OldName1\0OldName2\0\0).
ftDriverDate
Date du package de pilotes, telle qu’elle est codée dans les fichiers du pilote.
dwlDriverVersion
Numéro de version du pilote. Cela provient de la structure de version du pilote.
pszMfgName
Pointeur vers une chaîne terminée par null qui spécifie le nom du fabricant.
pszOEMUrl
Pointeur vers une chaîne terminée par null qui spécifie l’URL du fabricant.
pszHardwareID
Pointeur vers une chaîne terminée par null qui spécifie l’ID matériel du pilote d’imprimante.
pszProvider
Pointeur vers une chaîne terminée par null qui spécifie le fournisseur du pilote d’imprimante (par exemple, « Microsoft Windows 8 »).
pszPrintProcessor
Pointeur vers une chaîne terminée par null qui spécifie le nom du processeur d’impression associé au pilote d’imprimante.
pszVendorSetup
Pointeur vers une chaîne terminée par null qui spécifie la DLL d’installation du fournisseur et le point d’entrée pour l’installation du fournisseur associé au pilote d’imprimante.
pszzColorProfiles
Pointeur vers une chaîne terminée par null qui spécifie tous les profils de couleur associés au pilote d’imprimante.
pszInfPath
Pointeur vers une chaîne terminée par null qui spécifie le chemin du fichier INF à l’intérieur du magasin de pilotes à partir duquel le pilote d’imprimante a été installé. Doit avoir la valeur NULL si vous utilisez les fonctions AddPrinterDriver ou AddPrinterDriverEx avec DRIVER_INFO_8.
dwPrinterDriverAttributes
Ce membre spécifie les propriétés liées au pilote d’imprimante. Doit être égal à zéro si vous utilisez les fonctions AddPrinterDriver ouAddPrinterDriverEx avec DRIVER_INFO_8. Le tableau suivant montre les indicateurs qui ont été définis pour le paramètre dwPrinterDriverAttributes .
| Nom/valeur de l’indicateur | Signification | Système d’exploitation minimal |
|---|---|---|
| PRINTER_DRIVER_PACKAGE_AWARE 0x00000001 |
Le pilote d’imprimante fait partie d’un package de pilotes. | Windows Vista |
| PRINTER_DRIVER_XPS 0x00000002 |
Le pilote d’imprimante prend en charge le format Microsoft XPS décrit dans la section Spécification du papier XML : Vue d’ensemble, ainsi que dans Comportement du produit, section <27>. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SANDBOX_ENABLED 0x00000004 |
Le pilote d’imprimante est compatible avec l’isolation du pilote d’imprimante. Pour plus d’informations, consultez Comportement du produit, section <28>. | Windows 7 Windows Server 2008 R2 |
| PRINTER_DRIVER_CLASS 0x00000008 |
Le pilote d’imprimante est un pilote d’imprimante de classe. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_DERIVED 0x00000010 |
Le pilote d’imprimante est un pilote d’imprimante dérivé. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_NOT_SHAREABLE 0x00000020 |
Les imprimantes qui utilisent ce pilote d’imprimante ne peuvent pas être partagées. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FAX 0x00000040 |
Le pilote d’imprimante est destiné à être utilisé avec les imprimantes de télécopie. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FILE 0x00000080 |
Le pilote d’imprimante est destiné à être utilisé avec les imprimantes de fichiers. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_VIRTUAL 0x00000100 |
Le pilote d’imprimante est destiné à être utilisé avec des imprimantes virtuelles. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_SERVICE 0x00000200 |
Le pilote d’imprimante est destiné à être utilisé avec des imprimantes de service. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SOFT_RESET_REQUIRED 0x00000400 |
Les imprimantes qui utilisent ce pilote d’imprimante doivent suivre les instructions décrites dans Définition de classe de périphérique USB. Pour plus d’informations, consultez Comportement du produit, section <36> | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_3D 0x00001000 |
Le pilote d’imprimante est destiné à être utilisé avec des imprimantes 3D. | Windows 8 Windows Server 2012 |
pszzCoreDriverDependencies
Pointeur vers une chaîne terminée par null qui contient toutes les dépendances principales du pilote d’imprimante pour le package de pilotes qui sont définies par pszInfPath. Doit avoir la valeur NULL si vous utilisez les fonctions AddPrinterDriver ou AddPrinterDriverEx avec DRIVER_INFO_8.
ftMinInboxDriverVerDate
Date autorisée la plus ancienne de tous les pilotes fournis avec Windows et dont dépend ce pilote.
dwlMinInboxDriverVerVersion
La version la plus ancienne autorisée de tous les pilotes fournis avec Windows et dont dépend ce pilote.
Remarques
Les chaînes de ces membres sont contenues dans le fichier INF utilisé pour ajouter le pilote.
Si vous appelez AddPrinterDriver ou AddPrinterDriverEx avec Level différent de 6 ou 8, puis vous appelez GetPrinterDriver ou EnumPrinterDrivers avec Level égal à 6 ou 8, la structure DRIVER_INFO_8 est retournée avec pszMfgName, pszOEMUrl, pszHardwareID et pszProvider défini sur NULL, dwlDriverVersion défini sur zéro et ftDriverDate défini sur (0,0).
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | winspool.h (inclure Winspool.h) |
Commentaires
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, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour