Comentarios

DRIVER_INFO_8A estructura (winspool.h)

  • Artículo
  • Tiempo de lectura: 5 minutos

La DRIVER_INFO_8 estructura contiene información del controlador de impresora.

Sintaxis

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;

Miembros

cVersion

Este miembro especifica la versión del sistema operativo para la que se escribió el controlador. Actualmente, puede ser lo siguiente.

Value 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 de 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 Multi-SZ que contiene los nombres de los archivos de 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 final.

pMonitorName

Puntero a una cadena terminada en NULL que especifica un monitor de lenguaje (por ejemplo, "monitor de PJL"). Este miembro puede ser NULL y debe especificarse solo para impresoras que puedan comunicarse bidireccionalmente.

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

Fecha del paquete de controladores, como se codifica en los archivos de 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 para el 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 instalació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 que se han definido 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 sección XML Paper Specification: Información general y también en Comportamiento del producto, .<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, vea 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á pensado para su uso con impresoras de fax. Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_FILE

0x00000080

 El controlador de impresora está pensado para su uso con impresoras de archivos. Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_VIRTUAL

0x00000100

 El controlador de impresora está pensado para su uso con impresoras virtuales. Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_SERVICE

0x00000200

 El controlador de impresora está pensado 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. Para más información, consulte la sección Comportamiento del producto. <36> Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_3D

0x00001000

 El controlador de impresora está pensado para su uso con impresoras 3D. Windows 8

Windows Server 2012

pszzCoreDriverDependencies

Puntero a una cadena terminada en NULL que contiene todas las dependencias principales del controlador de impresora para el paquete de controladores definidos 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 todos los controladores incluidos con Windows y de los que depende este controlador.

dwlMinInboxDriverVerVersion

La versión más antigua permitida de todos los controladores incluidos con Windows y de los que depende este controlador.

Observaciones

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 un nivel no igual a 6 u 8, y, a continuación, llama a GetPrinterDriver o EnumPrinterDrivers con level igual a 6 u 8, la estructura 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

   
Encabezado winspool.h (incluir Winspool.h)