Describing Printer Memory Configurations

Important

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 the Print support app design guide.

A Unidrv minidriver can contain descriptions of a printer's possible and default memory configurations, so that Unidrv can attempt to keep track of printer memory usage. Each memory configuration description includes values for both the total memory and available memory. Available memory can be used for downloading fonts, protecting pages, and other operations controlled by Unidrv.

Within a GPD file, you can use two methods to describe a printer's possible memory configurations. Both methods involve specifying attributes within a *Feature entry for the Memory feature, which is one of the standard features. The two methods are as follows:

1. You can specify every possible configuration in a separate *Option entry within the *Feature entry. Each *Option entry must contain a *MemoryConfigKB attribute, which is described in Option Attributes for the Memory Feature.

   For example, to specify that a printer can have two memory configurations, a 1-megabyte configuration with 450 kilobytes available and a 2-megabyte configuration with 1350 kilobytes available, you can use the following GPD entries:

   *Feature: Memory
   {
       *Name: "Printer Memory"
       *DefaultOption: 1MB
       *Option: 1MB
       {
           *Name: "Standard 1MB"
           *MemoryConfigKB: PAIR(1024, 450)
       }
       *Option: 2MB 
       {
           *Name: "Add-On 2MB"
           *MemoryConfigKB: PAIR(2048,1350)
       }
   }
   
   

2. Alternatively, the *Feature entry can contain one or more *MemConfigKB or *MemConfigMB attributes instead of *Option entries. This is simply a way to specify memory options without including a set of *Option entries. Each *MemConfigKB or *MemConfigMB attribute represents a memory option.

   For example, to specify the same two configurations, a 1-megabyte configuration with 450 kilobytes available and a 2-megabyte configuration with 1350 kilobytes available, you can use the following GPD entries:

   *Feature: Memory
   {
       *Name: "Printer Memory"
       *DefaultOption: 1024KB
       *MemConfigKB: PAIR(1024, 450)
       *MemConfigKB: PAIR(2048, 1350)
   }
   
   

   The GPD parser creates a displayable option name for each configuration, based on the first entry in the PAIR statement. In the example, option names would be "1024KB" and "2048KB". The argument to the *DefaultOption attribute must match one of these names.

Both method 1 and method 2 can be used within a single *Feature entry.

If parser-generated option names are incompatible with localization requirements, use method 1 instead of method 2.

Whichever method you use, the Unidrv user interface displays the memory feature options in the device's printer property sheet.

If your minidriver specifies memory configurations, it can also specify the types of data that can be stored in printer memory and use up its available space. The *MemoryUsage attribute is one of the printer capability attributes, and you can use it to indicate to Unidrv whether font, raster, or vector data, or a combination of the three, are stored within printer memory. For each type specified, Unidrv attempts to keep track of how much printer memory is in use.