структура DRIVER_INFO_8A (winspool.h)

Статья
02/07/2025

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

Синтаксис

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;

Члены

cVersion

Этот член указывает версию операционной системы, для которой был написан драйвер. В настоящее время это может быть следующее.

Ценность	Значение
3	Драйвер для Microsoft Windows 2000, XP или Windows Vista.

pName

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

pEnvironment

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

pDriverPath

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

pDataFile

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

pConfigFile

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

pHelpFile

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

pDependentFiles

Указатель на строку Multi-SZ, содержащую имена файлов, от которых зависит драйвер. Имена файлов хранятся в виде последовательной серии строк, завершаемых с нуля, за которой следует пустая строка. Например, Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0, где \0 представляет конечный символ NULL.

pMonitorName

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

pDefaultDataType

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

pszzPreviousNames

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

ftDriverDate

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

dwlDriverVersion

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

pszMfgName

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

pszOEMUrl

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

pszHardwareID

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

pszProvider

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

pszPrintProcessor

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

pszVendorSetup

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

pszzColorProfiles

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

pszInfPath

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

dwPrinterDriverAttributes

Этот элемент задает связанные свойства драйвера принтера. Должно быть равно нулю, если функции AddPrinterDriver или AddPrinterDriverEx с DRIVER_INFO_8. В следующей таблице показаны флаги, определенные для параметра dwPrinterDriverAttributes.

Имя и значение флага	Значение	Минимальная ОС
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
PRINTER_DRIVER_CATEGORY_3D 0x00001000	Драйвер принтера предназначен для использования с трехмерными принтерами.	Windows 8 Windows Server 2012

pszzCoreDriverDependencies

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

ftMinInboxDriverVerDate

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

dwlMinInboxDriverVerVersion

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

Замечания

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

При вызове AddPrinterDriver или AddPrinterDriverEx с уровнем не равно 6 или 8, а затем вызывается GetPrinterDriver или EnumPrinterDrivers с уровнем 6 или 8, структура DRIVER_INFO_8 возвращается с помощью pszMfgName, pszOEMUrl, pszHardwareID и pszProvider значение NULL, dwlDriverVersion установлено равным нулю, а для ftDriverDate задано значение (0,0).

Требования

Требование	Ценность
заголовка	winspool.h (include Winspool.h)

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

структура DRIVER_INFO_8A (winspool.h)

Синтаксис

Члены

Замечания

Требования

Обратная связь

Дополнительные ресурсы