IPrintCoreUI2::DrvGetDriverSetting method (prcomoem.h)

The IPrintCoreUI2::DrvGetDriverSetting method is provided by the Windows XP Pscript5 driver so that Pscript5 user interface plug-ins can obtain the current status of printer features and other internal information.

Syntax

HRESULT DrvGetDriverSetting(
  PVOID  pci,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

Parameters

pci

Caller-supplied pointer to an OEMUIOBJ structure.

Feature

Caller-supplied value identifying the printer feature for which option settings are returned. This can be either a string pointer or a constant, as described in the following Remarks section.

pOutput

Caller-supplied pointer to a buffer to receive the specified information.

cbSize

Caller-supplied size, in bytes, of the buffer pointed to by pOutput.

pcbNeeded

Caller-supplied pointer to a location to receive the minimum buffer size required to contain the requested information.

pdwOptionsReturned

Caller-supplied pointer to a location to receive the number of option strings placed in pOutput.

Return value

This method must return one of the following values.

Remarks

This method is inherited from the IPrintOemDriverUI COM Interface, and can be called only by Windows XP and later Pscript5 UI plug-ins that do not fully replace the core driver's standard UI pages, and is supported during the UI plug-in's IPrintOemUI::DocumentPropertySheets and IPrintOemUI::DevicePropertySheets functions, and their property sheet callback routines. When this method is supported, it has the same behavior as IPrintOemDriverUI::DrvGetDriverSetting. When it is not supported, this method should return E_NOTIMPL.

Requirements

See also

IPrintCoreUI2

IPrintOemDriverUI::DrvGetDriverSetting

IPrintOemUI::DevicePropertySheets

IPrintOemUI::DocumentPropertySheets