Using GetOptions and SetOptions

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.

GetOptions can be called to retrieve the driver's current setting for features whose keywords are listed in the buffer pointed to by the pmszFeaturesRequested input parameter.

For example, in a call to GetOptions, suppose that the pmszFeaturesRequested input buffer contains this string (in MULTI_SZ format):

"PageSize\0Duplex\0Resolution\0\0"

After the GetOptions method returns, the output pmszFeatureOptionBuf could contain the following string (also in MULTI_SZ format):

"PageSize\0Letter\0Duplex\0DuplexTumble\0Resolution\0300dpi\0\0"

This example shows that GetOptions retrieved the option keywords for PageSize (Letter), Duplex (DuplexTumble), and Resolution (300dpi).

SetOptions can be called to change the driver's current setting based on the feature/option keyword pairs in the pmszFeatureOptionBuf input buffer.

There are two categories of features that are supported:

PPD Features

Driver Features