structure DRIVER_INFO_8

  • Article

Contient des informations sur le pilote d’imprimante.

Syntaxe

typedef struct _DRIVER_INFO_8 {
  DWORD     cVersion;
  LPTSTR    pName;
  LPTSTR    pEnvironment;
  LPTSTR    pDriverPath;
  LPTSTR    pDataFile;
  LPTSTR    pConfigFile;
  LPTSTR    pHelpFile;
  LPTSTR    pDependentFiles;
  LPTSTR    pMonitorName;
  LPTSTR    pDefaultDataType;
  LPTSTR    pszzPreviousNames;
  FILETIME  ftDriverDate;
  DWORDLONG dwlDriverVersion;
  LPTSTR    pszMfgName;
  LPTSTR    pszOEMUrl;
  LPTSTR    pszHardwareID;
  LPTSTR    pszProvider;
  LPTSTR    pszPrintProcessor;
  LPTSTR    pszVendorSetup;
  LPTSTR    pszzColorProfiles;
  LPTSTR    pszInfPath;
  DWORD     dwPrinterDriverAttributes;
  LPTSTR    pszzCoreDriverDependencies;
  FILETIME  ftMinInboxDriverVerDate;
  DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8, *PDRIVER_INFO_8, *LPDRIVER_INFO_8;

Membres

cVersion

Version du système d’exploitation pour laquelle le pilote a été écrit. La valeur prise en charge est 3.

pName

Pointeur vers une chaîne terminée par null qui spécifie le nom du pilote (par exemple, QMS 810).

pEnvironnement

Pointeur vers une chaîne terminée par null qui spécifie l’environnement pour lequel le pilote a été écrit (par exemple, Windows x86, Windows IA64 et Windows x64).

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 mémoire tampon MultiSZ qui contient une séquence de chaînes terminées par null. Chaque chaîne terminée par un null dans la mémoire tampon contient le nom d’un fichier dont dépend le pilote. La séquence de chaînes est terminée par une chaîne vide de longueur nulle. Si pDependentFiles n’a pas la valeur NULL et ne contient aucun nom de fichier, il pointe vers une mémoire tampon qui contient deux chaînes vides.

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 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 2000 »).

pszPrintProcessor

Pointeur vers une chaîne terminée par null qui spécifie le processeur d’impression (par exemple, « WinPrint »).

pszVendorSetup

Pointeur vers une chaîne terminée par null qui spécifie la DLL d’installation du pilote et le point d’entrée du fournisseur.

pszzColorProfiles

Pointeur vers une chaîne terminée par null qui spécifie les profils de couleur associés au pilote.

pszInfPath

Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès au fichier .inf du pilote dans le magasin de pilotes. (Voir Remarques.) Cette valeur doit être NULL si le DRIVER_INFO_8 est passé à AddPrinterDriver ou AddPrinterDriverEx.

dwPrinterDriverAttributes

Indicateurs d’attribut pour les pilotes d’imprimante. Cette valeur doit être 0 si le DRIVER_INFO_8 est passé à AddPrinterDriver ou AddPrinterDriverEx. Sinon, il peut s’agir de n’importe quelle combinaison des indicateurs suivants :

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 la définition de classe de périphérique USB. Pour plus d’informations, consultez Comportement du produit, section <36> Windows 8
Windows Server 2012

pszzCoreDriverDependencies

Pointeur vers une chaîne multi string terminée par null qui spécifie tous les principaux pilotes d’imprimante dont dépend le pilote. Cette valeur doit être NULL si le DRIVER_INFO_8 est passé à AddPrinterDriver ou AddPrinterDriverEx.

ftMinInboxDriverVerDate

Date la plus ancienne autorisée de tous les pilotes fournis avec Windows et dont ce pilote dépend.

dwlMinInboxDriverVerVersion

La première version autorisée de tous les pilotes fournis avec Windows et dont ce pilote dépend.

Notes

Les chaînes de ces membres sont contenues dans le fichier .inf utilisé pour ajouter le pilote.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2008 [applications de bureau uniquement]
En-tête
Winspool.h (inclure Windows.h)
Noms Unicode et ANSI
 _DRIVER_INFO_8W (Unicode) et _DRIVER_INFO_8A (ANSI)

Voir aussi

Impression

Structures de l’API spouleur d’impression

AddPrinterDriver

AddPrinterDriverEx