INF InboxVersionRequired Directive

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.

For package-aware drivers, you can use the InboxVersionRequired INF directive to specify a minimum acceptable version for all core drivers that the INF references. You can use the UseDriverVer keyword to specify the minimum version. This minimum version applies to all referenced core drivers in the INF.

The following example package-aware-driver section shows how you insert the InboxVersionRequired INF directive:

[PrinterPackageInstallation.amd64]
PackageAware=TRUE
CoreDriverDependencies={D20EA372-DD35-4950-9ED8-A6335AFE79F0},{D20EA372-DD35-4950-9ED8-A6335AFE79F3}
InboxVersionRequired=UseDriverVer

If the UseDriverVer keyword is used as the value for InboxVersionRequired, UseDriverVer informs the class installer to use the DriverVer directive version string from the INF that is being parsed as the minimum acceptable version of any core drivers. You must be careful when you service drivers that use the UseDriverVer keyword. All core drivers that are referenced by an INF must be the same or higher version for installation to be successful.

You can also specify specific version strings as the value for InboxVersionRequired. These version strings follow the same formatting as the DriverVer string that is specified in the INF Version Section. For more information about the DriverVer string format, see INF DriverVer Directive.

The following example shows how you set InboxVersionRequired to a specific version string:

InboxVersionRequired=09/28/1999,5.00.2136.1