Platform SDK: Windows GDI

DRIVER_INFO_6

The DRIVER_INFO_6 structure contains printer driver information.

typedef struct _DRIVER_INFO_6 {
  DWORD   cVersion; 
  LPTSTR     pName;                // QMS 810
  LPTSTR     pEnvironment;         // Win32 x86
  LPTSTR     pDriverPath;          // c:\drivers\pscript.dll
  LPTSTR     pDataFile;            // c:\drivers\QMS810.PPD
  LPTSTR     pConfigFile;         // c:\drivers\PSCRPTUI.DLL
  LPTSTR     pHelpFile;           // c:\drivers\PSCRPTUI.HLP
  LPTSTR     pDependentFiles;     // several files
  LPTSTR     pMonitorName;        // "PJL monitor"
  LPTSTR     pDefaultDataType;    // "EMF"
  LPTSTR     pszzPreviousNames;   // "OldName1\0OldName2\0\0
  FILETIME   ftDriverDate; 
  DWORDLONG  dwlDriverVersion; 
  LPTSTR     pszMfgName; 
  LPTSTR     pszOEMUrl; 
  LPTSTR     pszHardwareID; 
  LPTSTR     pszProvider; 
} DRIVER_INFO_6, *PDRIVER_INFO_6, *LPDRIVER_INFO_6;

Members

cVersion
Specifies the operating system version for which the driver was written. Currently it can be the following.
Value Meaning
3 Driver for Windows 2000.

pName
Pointer to a null-terminated string that specifies the name of the driver (for example, QMS 810).
pEnvironment
Pointer to a null-terminated string that specifies the environment for which the driver was written (for example, Windows NT x86, Windows NT R4000, Windows NT Alpha_AXP, or Windows 4.0).
pDriverPath
Pointer to a null-terminated string that specifies a file name or a full path and file name for the file that contains the device driver (for example, C:\DRIVERS\Pscript.dll).
pDataFile
Pointer to a null-terminated string that specifies a file name or a full path and file name for the file that contains driver data (for example, C:\DRIVERS\Qms810.ppd).
pConfigFile
Pointer to a null-terminated string that specifies a file name or a full path and file name for the device driver's configuration dynamic-link library (for example, C:\DRIVERS\Pscrptui.dll).
pHelpFile
Pointer to a null-terminated string that specifies a file name or a full path and file name for the device driver's help file (for example, C:\DRIVERS\Pscrptui.hlp).
pDependentFiles
Pointer to a null-terminated string that specifies the files the driver depends on. Each file name is separated by a backslash and a null character (for example, Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0).
pMonitorName
Pointer to a null-terminated string that specifies a language monitor (for example, "PJL monitor"). This member can be NULL and should be specified only for printers capable of bidirectional communication.
pDefaultDataType
Pointer to a null-terminated string that specifies the default data type of the print job (for example, "EMF").
pszzPreviousNames
Pointer to a null-terminated string that specifies any previous printer driver names that are compatible with this driver (for example, OldName1\0OldName2\0\0).
ftDriverDate
The date of the driver package, as coded in the driver files.
dwlDriverVersion
Version number of the driver. This comes out of the version structure of the driver.
pszMfgName
Pointer to a null-terminated string that specifies the manufacturer's name.
pszOEMUrl
Pointer to a null-terminated string that specifies the URL for the manufacturer.
pszHardwareID
Pointer to a null-terminated string that specifies the hardware ID for the printer driver.
pszProvider
Pointer to a null-terminated string that specifies the provider of the printer driver (for example, "Microsoft Windows 2000")

Remarks

The strings for these members are contained in the .inf file that is used to add the driver.

Currently pszzPreviousNames is only used during Windows 95/98 to Windows 2000 point and print.

If you call AddPrinterDriver or AddPrinterDriverEx with Level not equal to 6, and then you call GetPrinterDriver or EnumPrinterDrivers with Level equal to 6, the DRIVER_INFO_6 structure is returned with pszMfgName, pszOEMUrl, pszHardwareID, and pszProvider set to NULL, dwlDriverVersion set to 0, and ftDriverDate set to (0,0).

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Winspool.h; include Windows.h.
  Unicode: Declared as Unicode and ANSI structures.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Structures, AddPrinterDriver, AddPrinterDriverEx, EnumPrinterDrivers, GetPrinterDriver