Compartir a través de


Manifiesto del controlador V4

Importante

Se recomienda usar el controlador de clase de bandeja de entrada IPP de Microsoft, junto con aplicaciones de soporte técnico de impresión (PSA), para personalizar la experiencia de impresión en Windows 10 y 11 para el desarrollo de dispositivos de impresora.

Para obtener más información, consulte Guía de diseño de aplicaciones para compatibilidad con impresión.

El manifiesto del controlador de impresión v4 es un archivo de texto que contiene todas las directivas de configuración específicas de la impresora. Un manifiesto del controlador de impresión v4 se usa con un archivo INF del controlador de impresión v4, como parte de la configuración de un controlador de impresión v4 específico de la impresora.

Las directivas de un manifiesto se organizan en secciones:

Sección DriverConfig

En la tabla siguiente se muestran las directivas que se usan en la sección DriverConfig.

Directiva Restricciones Uso
RequiredFiles

Incluye archivos de ntprint.inf o ntprint4.inf.

La directiva RequiredFiles admite el siguiente valor en Windows 10:

PWGRRenderFilter.dll: agrega el filtro de representación del ráster PWG de Microsoft a la lista de archivos dependientes del controlador.

El filtro de representación del filtro de representación de PWG requiere que el controlador use un archivo PrintDeviceCapabilities para la configuración.
Unidrv.dll, pscript5.dll y mxdwdrv.dll deben omitirse en esta lista. Se resolverán automáticamente. Ejemplos:

RequiredFiles=
UNIRES.DLL,
STDNAMES. GPD
V3HOSTINGFILTER.DLL
RequiredClass

Hace que este controlador incluya todos los archivos de un controlador de clase definido mediante el nombre descriptivo del controlador del dispositivo y su GUID como clave. Este es el mecanismo para vincular un controlador printclass a un controlador específico del modelo.
Una clase driver no puede usar la directiva RequiredClass. Al usar RequiredClass, debe evitar conflictos de nombres de archivo entre el controlador de impresora y el controlador print Class al que está vinculando.

Aunque los archivos con nombres similares no se sobrescribirán entre sí, puede ser difícil durante la solución de problemas, distinguir entre el archivo del paquete de controladores de clase y el archivo del controlador de impresora v4.
Ejemplo:

RequiredClass=
"Fabrikam PCL5e Class Driver",(9343720D-B67E-4451-B93F-6F721C439771)
DriverFile

Esto apunta al binario de representación. Mxdwdrv es el valor predeterminado, pero los controladores de clase pueden especificar unidrv.dll o pscript5.dll. Esto es funcionalmente idéntico a la misma directiva en un INF v3.
Solo se puede establecer en un controlador de clase. Las opciones válidas son unidrv.dll o pscript5.dll. Los controladores de impresión V4 heredan de requiredClass o de forma predeterminada a mxdwdrv.dll DriverFile=unidrv.dll
DataFile

Esto define el GPD o PPD principal para este controlador. Esto es funcionalmente idéntico a la misma directiva en un INF v3.

En Windows 10, los controladores de impresión v4 pueden seguir especificando un ARCHIVO de datos GPD o PPD, pero también pueden describir un DataFile que esté en el formato PrintDeviceCapabilities.
Necesario. Ejemplos:

DataFile=FAPDL.gpd
DataFile=FAPDL.xml
DataFileType

DataFileType debe usarse al describir un archivo PrintDeviceCapabilities como dataFile, y también se puede usar con un DataFile basado en GPD o PPD.
Necesario para el archivo PrintDeviceCapabilities. Ejemplo:

DataFileType=
"application/vnd.ms-PrintDeviceCapabilities+xml"
Flags

Se usa para especificar atributos opcionales asociados al controlador.

NotShareable: esta marca especifica que el controlador no se puede compartir. Esto es adecuado para controladores virtuales, como el escritor de documentos de Microsoft XPS.

SoftResetOnJobCancellation: esta marca especifica que el dispositivo requiere un restablecimiento temporal USB (IOCTL_USBPRINT_SOFT_RESET) en la cancelación del trabajo de impresión. ArchiveEnabled El controlador v4 usa esta marca para solicitar XPS optimizado para archivado como un archivo de cola.
Ninguno. Ejemplos:

Flags=
NotShareable,
SoftResetOnJobCancellation
Flags=
ArchiveEnabled,NotShareable
PrinterDriverID

Se trata de un identificador único que describe el controlador de impresión. Si dos controladores especifican el mismo PrinterDriverID, deben ser compatibles para compartir y admitir las mismas extensiones de impresora.
Necesario. PrinterDriverID=
{guid}
PropertyBag

Especifica un contenedor de propiedades de controlador para este controlador. Se trata de un archivo compilado generado por DriverPropertyBagTool.exe o Visual Studio.
Ninguno. PropertyBag=
FAProperty.dpb
ResourceFile

Define el nombre del archivo DLL de recursos de cadena del controlador.

En Windows 10, los controladores pueden especificar un ResourceFile mediante el formato .resx.
Ninguno. Ejemplos:

ResourceFile=
FARC.dll
ConstraintScript

Define el nombre del archivo de restricción de JavaScript del controlador.
Ninguno. ConstraintScript=
FAConst.js
DriverCategory

Define la categoría del dispositivo entre una de varias opciones. Las opciones válidas son las siguientes:
PrintFax.Fax PrintFax.Printer PrintFax.Printer.3D PrintFax.Printer.File PrintFax.Printer.Service PrintFax.Printer.Virtual
Necesario. DriverCategory=
PrintFax.Printer

Para obtener más información sobre otras categorías de controladores, vea Entradas de archivo INF de impresora.
PrinterExtensionUrl

Especifica una dirección URL para que el usuario obtenga una copia de la aplicación de extensión Printer. Se usa en el uso compartido de impresoras.
Ninguno. PrinterExtensionUrl=
"https://www.fabrikam.com/files/setup.exe";
DevModeMap

Especifica el archivo de asignación de Devmode. Se trata de un archivo XML que se usa con PrintTicket para la conversión DEVMODE en código JavaScript.
Ninguno. DevModeMap=
fadmmap.xml
EventFile

Especifica el archivo XML de evento de controlador.
Ninguno. EventFile=
faevents.xml
QueueProperties

Especifica el formato de un contenedor de propiedades de cola. Se trata de un archivo XML y NO debe compilarse.
Ninguno. QueueProperties=
faQueueProps.xml
BidiUSBStatusInterface

Especifica una lista de identificadores de hardware que coinciden con una o varias interfaces de dispositivo que se usarán para las comunicaciones USB Bidi.
Ninguno, pero solo se debe admitir si el estado se realiza a través de una interfaz USB que no es la interfaz de impresión. BidiUSBStatusInterface=
"USB\vid_1234&pid_1234",
"USB\vid_1234&pid_4567"
UserPropertyBagScope

Esta directiva especifica el ámbito del contenedor de propiedades de usuario como Queue o Manufacturer.
Si se omite esta directiva, Queue es el valor predeterminado. Las opciones válidas para esta directiva son las siguientes:

Cola: esta es la configuración predeterminada y coincide con el comportamiento de Windows 8. Fabricante: todas las colas que usan la misma cadena fabricante del INF usan el mismo contenedor de propiedades de usuario.
Ninguno. UserPropertyBagScope=
Fabricante
RetrievePrintDeviceCapabilitiesFromDevice

Los controladores v4 pueden especificar que deben recuperar un archivo PrintDeviceCapabilities de impresoras WS-Print v2.0, siempre y cuando establezcan un archivo PrintDeviceCapabilities como dataFile del controlador y dataFileType también indican que dataFile es de tipo MIME "application/vnd.ms-PrintDeviceCapabilities+xml".

Opciones válidas:

True: permite que el archivo DataFile local del controlador se reemplace por el archivo PrintDeviceCapabilities del dispositivo.

False: el archivo DataFile local del controlador no se reemplazará por el archivo PrintDeviceCapabilities del dispositivo.

Si no se especifica, el valor predeterminado de esta directiva es false.
Ninguno. Ejemplo:

RetrievePrintDeviceCapabilitiesFromDevice=
true

Sección BidiFiles

La sección BidiFiles se usa para definir archivos de extensión Bidi. Es idéntico al formato de Windows 7 para TCP y WSD. Las palabras clave USB son nuevas.

En la tabla siguiente se muestran las directivas que se usan en la sección BidiFiles.

Directiva Restricciones Uso
BidiSPMFile
Esto define el archivo de extensión Bidi para una impresora basada en TCP/IP.
Ninguno. BidiSPMFile=FaBidiSPM.xml
BidiWSDFile
Esto define el archivo de extensión Bidi para una impresora basada en WSD.
Ninguno. BidiWSDFile=FABidiWSD.xml
BidiUSBFile
Esto define la extensión Bidi para USB.
Ninguno. BidiUSBFile=FABidiUSB.xml
BidiUSBJSFile
Esto define la extensión de JavaScript para USB.
Ninguno. BidiUSBJSFile=FABidiUSBJS.js

Sección DriverRender

En la tabla siguiente se muestran las directivas que se usan en la sección DriverRender.

Directiva Restricciones Uso
PageOutputQuality. [OptionName]
Cambia la compresión de imagen en función del valor del trabajo PrintTicket para PageOutputQuality
OptionName debe ser un nombre especificado en el espacio de nombres PrintSchema estándar. PageOutputQuality.Draft=
MxdcImageType.JPEGHigh

PageOutputQuality.Normal=
MxdcImageType.JPEGMedium

PageOutputQuality.High=
MxdcImageType.PNG
XpsFormat
Cambia el formato XPS generado por el sistema de impresión para este controlador. Se pueden especificar varios valores y el orden representa la preferencia del controlador.
No está disponible para su uso en controladores de clase que usan la representación Unidrv/PScript. XpsFormat=XPS

XpsFormat=OpenXPS

XPSFormat=OpenXPS,XPS

XPSFormat=XPS,OpenXPS
OutputFormat
La directiva OutputFormat describe una única PDL que este controlador genera mediante un tipo MIME.
Esta información se usa durante la operación CreateJob o CreateJob2 para impresoras WSD.
Ninguno. Entre los tipos de uso válidos se incluyen:

OutputFormat=
"application/oxps"

OutputFormat=
"application/vnd.ms-xpsdocument"

OutputFormat=
"image/pwg-raster"

OutputFormat=
"application/vnd.ms-3mfdocument"

Cualquier otro tipo MIME definido válido también se puede especificar aquí.

La palabra clave MxdcImageType para la directiva PageOutputQuality tiene los siguientes valores permitidos:

Valor mxdcImageType
MxdcImageType.JPEGHigh
Jpeg de alta compresión (archivos más pequeños)
MxdcImageType.JPEGMedium
JPEG de compresión media
MxdcImageType.JPEGLow
Jpeg de compresión baja
MxdcImageType.PNG
Tipo de archivo PNG (archivos más grandes)

Sección FileSave

En esta sección se admite el escenario de guardado de archivos. Cuando se instala un controlador de impresión v4 en el nuevo tipo de puerto PORTPROMPT, esta sección especifica las extensiones de archivo que se van a mostrar en la ventana Archivo común y también especifica las cadenas de recursos localizables que admiten las extensiones y el propio cuadro de diálogo.

Directiva Restricciones Uso
<FileExtensionName>
Esta directiva describe fileExtension que se va a usar al guardar un archivo de este controlador mediante el puerto PORTPROMPT. El valor es un resourceID del resourceFile del controlador. Solo para XPS y OXPS, se puede especificar un resourceID de 0 y el administrador de trabajos de impresión usará sus recursos internos para estos.
Ninguno. <FileExtensionName>=
<resourceID>
Xps=1234
SaveAsTitle
Esta directiva describe el título que se va a usar en el cuadro de diálogo Guardar archivo. El valor es un resourceID del resourceFile del controlador.
Ninguno. SaveAsTitle=
<resourceID>
SaveAsTitle=4321

Sección PrinterExtensions

La sección PrinterExtensions especifica una extensión de impresora y los modos de invocación que admite. Para ambas entradas, la aplicación se registrará automáticamente con el sistema de impresión. Además, la aplicación se configura con dos parámetros diferentes, PrinterDriverID y ReasonID, en ese orden. Como resultado, cada entrada debe usar un GUID PrinterExtensionID diferente.

En la tabla siguiente se muestran las directivas que se usan en la sección PrinterExtensions.

Directiva Restricciones Uso
DriverEvent
Aplicación que atiende el modo DriverEvent.
Ninguno. DriverEvent=
app.exe,{extensionID GUID}
PrintPreferences
Aplicación que mantiene el modo PrintPreferences.
Ninguno. PrintPreferences=
app.exe, {extensionID GUID}

A continuación se muestra un ejemplo de un manifiesto de controlador de impresión v4.

[DriverConfig]
DataFile=FAPDL.xml
RequiredFiles=UNIRES.DLL,STDNAMES.GPD,STDDTYPE.GDL,STDSCHEM.GDL,STDSCHMX.GDL,XPSSVCS.DLL,MSXPSINC.GPD,PWGRRenderFilter.DLL
ResourceFile=FARC.dll
PropertyBag=FAProperty.dpb
PrinterDriverID={GUID}
DriverCategory=PrintFax.Printer
ConstraintScript=faconst.js
EventFile=faevents.xml
PrinterExtensionUrl="https://www.fabrikam.com/download.asp?uiapp=120"
UserPropertyBagScope=Manufacturer
DataFileType="application/vnd.ms-PrintDeviceCapabilities+xml"
RetrievePrintDeviceCapabilitiesFromDevice=true

[BidiFiles]
BidiSPMFile=FABidiSPM.xml
BidiWSDFile=FABidiWSD.xml
BidiUSBFile=FaBidiUSB.xml
BidiUSBJSFile=FABidiUSBJS.js

[DriverRender]
PageOutputQuality.Draft=MxdcImageType.JPEGHigh
PageOutputQuality.Normal=MxdcImageType.JPEGMedium
PageOutputQuality.High=MxdcImageType.PNG
OutputFormat="image/pwg-raster"

[PrinterExtensions]
DriverEvent=FAapp.exe,{GUID}
PrintPreferences=FAapp.exe,{GUID2}

Entradas del archivo INF de impresora