XPSDrv installation

Important

The modern print platform is Windows' preferred means of communicating with printers. We recommend that you use Microsoft's IPP inbox class driver, along with Print Support Apps (PSA), to customize the print experience in Windows 10 and 11 for printer device development.

For more information, see Modern print platform and the Print support app design guide.

To be properly installed by the spooler, XPSDrv drivers must include the following:

  • The CopyFiles directive of the driver INF file must reference the filter pipeline configuration file.

  • The Needs directive must reference Xpsdrv.oem. For more information about the Needs directive, see INF DDInstall Section.

  • If the configuration module is based on Unidrv, the Needs directive must reference Unidrv.oem and Xpsgpd.oem. Likewise, if the XPSDrv driver configuration module is based on PScript5, the Needs directive must reference Pscript.oem and Xpsppd.oem.

The following code example illustrates an INF file with the preceding changes.

[Version]
Signature="$Windows NT$"
Provider=%MS%
Class=Printer
ClassGUID={4D36E979-E325-11CE-BFC1-08002BE10318}
CatalogFile=ntprint.cat
DriverVer=10/11/2005,6.0.5242.0
PnpLockdown=1

[Manufacturer]
%MS% = Microsoft,NTamd64

[Microsoft.NTamd64]
"XPSDrv Sample Driver" = INSTALL_XDSMPL_FILTERS

[INSTALL_XDSMPL_FILTERS]
CopyFiles=XPSDrvSample,ConfigPlugin,COLORPROFILES
DriverFile=mxdwdrv.dll
ConfigFile=unidrvui.dll
HelpFile=unidrv.HLP
DataFile=XDSmpl.GPD
Include=NTPRINT.INF
Needs=UNIDRV.OEM, XPSGPD.OEM, XPSDRV.OEM
ICMProfiles=xdwscRGB.cdmp

[XPSDrvSample]
xdsmpl-pipelineconfig.xml
...