IPrintCoreUI2::DrvGetDriverSetting method

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


STDMETHOD 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.

Return codeDescription
S_OK

The operation succeeded.

E_FAIL

The operation failed.

E_NOTIMPL

The method is not implemented.

 

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

Header

Prcomoem.h (include Prcomoem.h)

See also

IPrintOemDriverUI::DrvGetDriverSetting
IPrintOemUI::DocumentPropertySheets
IPrintOemUI::DevicePropertySheets

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft