структура DRIVER_INFO_8W (winspool.h)
Структура DRIVER_INFO_8 содержит сведения о драйвере принтера.
Синтаксис
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;
Члены
cVersion
Этот член указывает версию операционной системы, для которой был написан драйвер. В настоящее время это может быть следующее.
| Значение | Значение |
|---|---|
| 3 | Драйвер для Microsoft Windows 2000, XP или Windows Vista. |
pName
Указатель на строку с пустым завершением, указывающую имя драйвера (например, QMS 810).
pEnvironment
Указатель на строку, завершающуюся значением NULL, которая указывает среду, для которой был написан драйвер (например, Microsoft Windows 7, 8 или Windows Server 2012).
pDriverPath
Указатель на строку, завершающуюся значением NULL, которая указывает имя файла или полный путь и имя файла, содержащего драйвер устройства (например, C:\DRIVERS\Pscript.dll).
pDataFile
Указатель на строку с пустым завершением, указывающую имя файла или полный путь и имя файла, содержащего данные драйвера (например, C:\DRIVERS\Qms810.ppd).
pConfigFile
Указатель на строку, завершающуюся значением NULL, которая указывает имя файла или полный путь и имя файла для динамической библиотеки конфигурации драйвера устройства (например, C:\DRIVERS\Pscrptui.dll).
pHelpFile
Указатель на строку со значением NULL, которая указывает имя файла или полный путь и имя файла справки драйвера устройства (например, C:\DRIVERS\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).
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 Paper: Обзор, а также в разделе Поведение продукта, раздел <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](Определение класса устройства USB. Дополнительные сведения см. в разделе Поведение продукта, раздел <36>. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_3D 0x00001000 |
Драйвер принтера предназначен для использования с трехмерными принтерами. | Windows 8 Windows Server 2012 |
pszzCoreDriverDependencies
Указатель на строку, завершающуюся значением NULL, которая содержит все зависимости драйвера основного принтера для пакета драйвера, определенного в pszInfPath. Должно иметь значение NULL при использовании функций AddPrinterDriver или AddPrinterDriverEx с DRIVER_INFO_8.
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 (включая Winspool.h) |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по