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.

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 .

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