Поделиться через

структура DRIVER_INFO_8

  • Статья

Содержит сведения о драйвере принтера.

Синтаксис

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;

Члены

cVersion

Версия операционной системы, для которой был написан драйвер. Поддерживаемое значение — 3.

pName

Указатель на строку, завершающуюся значением NULL, которая указывает имя драйвера (например, QMS 810).

pEnvironment

Указатель на строку, завершающуюся значением NULL, которая указывает среду, для которой был написан драйвер (например, Windows x86, Windows IA64 и Windows x64).

pDriverPath

Указатель на строку, завершающуюся пустым значением, которая указывает имя файла или полный путь и имя файла, содержащего драйвер устройства (например, C:\DRIVERS\Pscript.dll).

pDataFile

Указатель на строку, завершающуюся null, которая указывает имя файла или полный путь и имя файла, содержащего данные драйвера (например, C:\DRIVERS\Qms810.ppd).

pConfigFile

Указатель на строку, завершающуюся null, которая указывает имя файла или полный путь и имя файла для библиотеки динамической компоновки конфигурации драйвера устройства (например, C:\DRIVERS\Pscrptui.dll).

pHelpFile

Указатель на строку со значением NULL, которая указывает имя файла или полный путь и имя файла справки драйвера устройства (например, C:\DRIVERS\Pscrptui.hlp).

pDependentFiles

Указатель на буфер MultiSZ, содержащий последовательность строк, завершаемых null. Каждая строка, завершающаяся значением NULL, в буфере содержит имя файла, от которых зависит драйвер. Последовательность строк завершается пустой строкой нулевой длины. Если pDependentFiles не имеет значения NULL и не содержит имен файлов, он будет указывать на буфер, содержащий две пустые строки.

pMonitorName

Указатель на строку, завершающуюся значением NULL, которая указывает языковой монитор (например, "Монитор PJL"). Этот элемент может иметь значение NULL и должен быть указан только для принтеров, поддерживающих двунаправленную связь.

pDefaultDataType

Указатель на строку, завершающуюся значением NULL, которая указывает тип данных по умолчанию для задания печати (например, "EMF").

pszzPreviousNames

Указатель на строку, завершающуюся значением NULL, которая указывает имена предыдущих драйверов принтера, совместимые с этим драйвером. Например, OldName1\0OldName2\0\0.

ftDriverDate

Дата пакета драйвера, закодированная в файлах драйверов.

dwlDriverVersion

Номер версии драйвера. Это происходит из структуры версий драйвера.

pszMfgName

Указатель на строку, завершающуюся нулевым значением, которая указывает имя производителя.

pszOEMUrl

Указатель на строку, завершающуюся значением NULL, которая указывает URL-адрес производителя.

pszHardwareID

Указатель на строку, завершающуюся значением NULL, которая указывает идентификатор оборудования для драйвера принтера.

pszProvider

Указатель на строку, завершающуюся значением NULL, которая указывает поставщика драйвера принтера (например, Microsoft Windows 2000).

pszPrintProcessor

Указатель на строку, завершающуюся значением NULL, которая указывает обработчик печати (например, "WinPrint").

pszVendorSetup

Указатель на строку, завершающуюся значением NULL, которая указывает dll и точку входа для установки драйвера поставщика.

pszzColorProfiles

Указатель на строку, завершающуюся значением NULL, которая указывает цветовые профили, связанные с драйвером.

pszInfPath

Указатель на строку, завершающуюся значением NULL, которая указывает путь к INF-файлу драйвера в хранилище драйверов. (См. примечания.) Это значение должно иметь значение NULL , если DRIVER_INFO_8 передается в AddPrinterDriver или AddPrinterDriverEx.

DwPrinterDriverAttributes

Флаги атрибутов для драйверов принтера. Значение должно быть равно 0, если DRIVER_INFO_8 передается в AddPrinterDriver или AddPrinterDriverEx. В противном случае это может быть любое сочетание следующих флагов:

Имя или значение флага Значение Минимальная ОС
PRINTER_DRIVER_PACKAGE_AWARE
0x00000001
 Драйвер принтера является частью пакета драйверов. Windows Vista
PRINTER_DRIVER_XPS
0x00000002
 Драйвер принтера поддерживает формат Microsoft XPS, описанный в разделе Спецификация XML-бумаги: обзор, а также в разделе Поведение продукта, раздел <27>. Windows 8
Windows Server 2012
PRINTER_DRIVER_SANDBOX_ENABLED
0x00000004
 Драйвер принтера совместим с изоляцией драйвера принтера. Дополнительные сведения см. в разделе Поведение продукта, раздел <28>. Windows 7
Windows Server 2008 R2
PRINTER_DRIVER_CLASS
0x00000008
 Драйвер принтера — это драйвер принтера класса. Windows 8
Windows Server 2012
PRINTER_DRIVER_DERIVED
0x00000010
 Драйвер принтера является производным драйвером принтера. Windows 8
Windows Server 2012
PRINTER_DRIVER_NOT_SHAREABLE
0x00000020
 Принтеры, использующие этот драйвер принтера, не могут быть общими. Windows 8
Windows Server 2012
PRINTER_DRIVER_CATEGORY_FAX
0x00000040
 Драйвер принтера предназначен для использования с принтерами факсов. Windows 8
Windows Server 2012
PRINTER_DRIVER_CATEGORY_FILE
0x00000080
 Драйвер принтера предназначен для использования с файловыми принтерами. Windows 8
Windows Server 2012
PRINTER_DRIVER_CATEGORY_VIRTUAL
0x00000100
 Драйвер принтера предназначен для использования с виртуальными принтерами. Windows 8
Windows Server 2012
PRINTER_DRIVER_CATEGORY_SERVICE
0x00000200
 Драйвер принтера предназначен для использования со служебными принтерами. Windows 8
Windows Server 2012
PRINTER_DRIVER_SOFT_RESET_REQUIRED
0x00000400
 Принтеры, использующие этот драйвер принтера, должны соответствовать рекомендациям, изложенным в разделе Определение класса USB-устройства. Дополнительные сведения см. в разделе Поведение продукта, раздел <36>. Windows 8
Windows Server 2012

pszzCoreDriverDependencies

Указатель на многострочное многострочное значение, завершающееся нулевым значением, которое указывает все основные драйверы принтера, от которые зависит драйвер. Это значение должно иметь значение NULL , если DRIVER_INFO_8 передается в AddPrinterDriver или AddPrinterDriverEx.

ftMinInboxDriverVerDate

Самая ранняя допустимая дата всех драйверов, которые поставляются с Windows и от которых зависит этот драйвер.

dwlMinInboxDriverVerVersion

Самая ранняя разрешенная версия всех драйверов, поставляемых с Windows и от которых зависит этот драйвер.

Комментарии

Строки для этих элементов содержатся в INF-файле, который используется для добавления драйвера.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
Заголовок
Winspool.h (включая Windows.h)
Имя в кодировке Юникод и ANSI
 _DRIVER_INFO_8W (Юникод) и _DRIVER_INFO_8A (ANSI)

См. также раздел

Вывод на печать

Структуры API очереди печати печати

AddPrinterDriver

AddPrinterDriverEx