estructura DRIVER_INFO_8W (winspool.h)
La estructura DRIVER_INFO_8 contiene información del controlador de impresora.
Sintaxis
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;
Miembros
cVersion
Este miembro especifica la versión del sistema operativo para la que se escribió el controlador. Actualmente puede ser lo siguiente.
| Valor | Significado |
|---|---|
| 3 | Controlador para Microsoft Windows 2000, XP o Windows Vista. |
pName
Puntero a una cadena terminada en null que especifica el nombre del controlador (por ejemplo, QMS 810).
pEnvironment
Puntero a una cadena terminada en null que especifica el entorno para el que se escribió el controlador (por ejemplo, Microsoft Windows 7, 8 o Windows Server 2012).
pDriverPath
Puntero a una cadena terminada en null que especifica un nombre de archivo o una ruta de acceso completa y un nombre de archivo para el archivo que contiene el controlador de dispositivo (por ejemplo, C:\DRIVERS\Pscript.dll).
pDataFile
Puntero a una cadena terminada en null que especifica un nombre de archivo o una ruta de acceso completa y un nombre de archivo para el archivo que contiene datos del controlador (por ejemplo, C:\DRIVERS\Qms810.ppd).
pConfigFile
Puntero a una cadena terminada en null que especifica un nombre de archivo o una ruta de acceso completa y un nombre de archivo para la biblioteca de vínculos dinámicos de configuración del controlador de dispositivo (por ejemplo, C:\DRIVERS\Pscrptui.dll).
pHelpFile
Puntero a una cadena terminada en null que especifica un nombre de archivo o una ruta de acceso completa y un nombre de archivo para el archivo de ayuda del controlador de dispositivo (por ejemplo, C:\DRIVERS\Pscrptui.hlp).
pDependentFiles
Puntero a una cadena multiSZ que contiene los nombres de los archivos en los que depende el controlador. Los nombres de archivo se almacenan como una serie contigua de cadenas terminadas en cero seguidas de una cadena vacía. Por ejemplo, Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0, donde \0 representa el carácter nulo de terminación.
pMonitorName
Puntero a una cadena terminada en null que especifica un monitor de idioma (por ejemplo, "monitor PJL"). Este miembro puede ser NULL y solo debe especificarse para impresoras capaces de comunicación bidireccional.
pDefaultDataType
Puntero a una cadena terminada en null que especifica el tipo de datos predeterminado del trabajo de impresión (por ejemplo, "EMF").
pszzPreviousNames
Puntero a una cadena terminada en null que especifica los nombres de controladores de impresora anteriores que son compatibles con este controlador (por ejemplo, OldName1\0OldName2\0\0).
ftDriverDate
La fecha del paquete de controladores, como se codifica en los archivos del controlador.
dwlDriverVersion
Número de versión del controlador. Esto sale de la estructura de versión del controlador.
pszMfgName
Puntero a una cadena terminada en null que especifica el nombre del fabricante.
pszOEMUrl
Puntero a una cadena terminada en null que especifica la dirección URL del fabricante.
pszHardwareID
Puntero a una cadena terminada en null que especifica el identificador de hardware del controlador de impresora.
pszProvider
Puntero a una cadena terminada en null que especifica el proveedor del controlador de impresora (por ejemplo, "Microsoft Windows 8").
pszPrintProcessor
Puntero a una cadena terminada en null que especifica el nombre del procesador de impresión asociado al controlador de impresora.
pszVendorSetup
Puntero a una cadena terminada en null que especifica el archivo DLL de instalación del proveedor y el punto de entrada para la configuración del proveedor que está asociado al controlador de impresora.
pszzColorProfiles
Puntero a una cadena terminada en null que especifica todos los perfiles de color asociados al controlador de impresora.
pszInfPath
Puntero a una cadena terminada en null que especifica la ruta de acceso del archivo INF dentro del almacén de controladores desde el que se instaló el controlador de impresora. Debe ser NULL si se usan las funciones AddPrinterDriver o AddPrinterDriverEx con DRIVER_INFO_8.
dwPrinterDriverAttributes
Este miembro especifica las propiedades relacionadas con el controlador de impresora. Debe ser cero si se usan las funciones AddPrinterDriver o AddPrinterDriverEx con DRIVER_INFO_8. En la tabla siguiente se muestran las marcas definidas para el parámetro dwPrinterDriverAttributes .
| Nombre y valor de marca | Significado | Sistema operativo mínimo |
|---|---|---|
| PRINTER_DRIVER_PACKAGE_AWARE 0x00000001 |
El controlador de impresora forma parte de un paquete de controladores. | Windows Vista |
| PRINTER_DRIVER_XPS 0x00000002 |
El controlador de impresora admite el formato XPS de Microsoft descrito en la especificación de papel XML: Información general y también en Comportamiento del producto, sección <27>. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SANDBOX_ENABLED 0x00000004 |
El controlador de impresora es compatible con el aislamiento del controlador de impresora. Para obtener más información, consulte Comportamiento del producto, sección <28>. | Windows 7 Windows Server 2008 R2 |
| PRINTER_DRIVER_CLASS 0x00000008 |
El controlador de impresora es un controlador de impresora de clase. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_DERIVED 0x00000010 |
El controlador de impresora es un controlador de impresora derivado. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_NOT_SHAREABLE 0x00000020 |
Las impresoras que usan este controlador de impresora no se pueden compartir. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FAX 0x00000040 |
El controlador de impresora está diseñado para su uso con impresoras de fax. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FILE 0x00000080 |
El controlador de impresora está diseñado para su uso con impresoras de archivos. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_VIRTUAL 0x00000100 |
El controlador de impresora está diseñado para su uso con impresoras virtuales. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_SERVICE 0x00000200 |
El controlador de impresora está diseñado para su uso con impresoras de servicio. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SOFT_RESET_REQUIRED 0x00000400 |
Las impresoras que usan este controlador de impresora deben seguir las instrucciones descritas en [Definición de clase de dispositivo USB](Definición de clase de dispositivo USB). Para obtener más información, consulte Comportamiento del producto, sección <36>. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_3D 0x00001000 |
El controlador de impresora está diseñado para su uso con impresoras 3D. | Windows 8 Windows Server 2012 |
pszzCoreDriverDependencies
Puntero a una cadena terminada en null que contiene todas las dependencias del controlador de impresora principal para el paquete de controladores definido por pszInfPath. Debe ser NULL si se usan las funciones AddPrinterDriver o AddPrinterDriverEx con DRIVER_INFO_8.
ftMinInboxDriverVerDate
La fecha más temprana permitida de los controladores que se incluyen con Windows y de los que depende este controlador.
dwlMinInboxDriverVerVersion
La versión más antigua permitida de los controladores que se incluyen con Windows y de los que depende este controlador.
Comentarios
Las cadenas de estos miembros están contenidas en el archivo INF que se usa para agregar el controlador.
Si llama a AddPrinterDriver o AddPrinterDriverEx con Level no es igual a 6 o 8, y, a continuación, llama a GetPrinterDriver o EnumPrinterDrivers con Level igual a 6 o 8, la estructura de DRIVER_INFO_8 se devuelve con pszMfgName, pszOEMUrl, pszHardwareID y pszProvider establecido en NULL, dwlDriverVersion establecido en cero y ftDriverDate establecido en (0,0).
Requisitos
| Requisito | Valor |
|---|---|
| Header | winspool.h (incluya Winspool.h) |