DRIVER_INFO_8W structure (winspool.h)

Article
03/13/2023

La structure DRIVER_INFO_8 contient des informations sur le pilote d’imprimante.

Syntaxe

typedef struct _DRIVER_INFO_8W {
  DWORD     cVersion;
  LPWSTR    pName;
  LPWSTR    pEnvironment;
  LPWSTR    pDriverPath;
  LPWSTR    pDataFile;
  LPWSTR    pConfigFile;
  LPWSTR    pHelpFile;
  LPWSTR    pDependentFiles;
  LPWSTR    pMonitorName;
  LPWSTR    pDefaultDataType;
  LPWSTR    pszzPreviousNames;
  FILETIME  ftDriverDate;
  DWORDLONG dwlDriverVersion;
  LPWSTR    pszMfgName;
  LPWSTR    pszOEMUrl;
  LPWSTR    pszHardwareID;
  LPWSTR    pszProvider;
  LPWSTR    pszPrintProcessor;
  LPWSTR    pszVendorSetup;
  LPWSTR    pszzColorProfiles;
  LPWSTR    pszInfPath;
  DWORD     dwPrinterDriverAttributes;
  LPWSTR    pszzCoreDriverDependencies;
  FILETIME  ftMinInboxDriverVerDate;
  DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8W, *PDRIVER_INFO_8W, *LPDRIVER_INFO_8W;

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 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 de 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ée 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 associées au pilote d’imprimante. Doit être égal à zéro si vous utilisez les fonctions AddPrinterDriver ou AddPrinterDriverEx avec DRIVER_INFO_8. Le tableau suivant présente 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 Xml Paper Specification : Overview et également dans Product Behavior, 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 utilisant 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 des 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](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)

Partager via

DRIVER_INFO_8W structure (winspool.h)

Syntaxe

Membres

Remarques

Configuration requise

Commentaires

Ressources supplémentaires