Edit

IPrintOemDriverPS::DrvGetDriverSetting method (prcomoem.h)

  • Article

The IPrintOemDriverPS::DrvGetDriverSetting method is provided by the Pscript5 driver so that rendering plug-ins can obtain the current status of printer features and other internal information.

Syntax

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

Parameters

pdriverobj

Caller-supplied pointer to a DEVOBJ structure.

Feature

Caller supplied value identifying the printer feature for which option settings will be 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

The method must return one of the following values.

Return code Description
S_OK
 The operation succeeded.
E_FAIL
 The operation failed
E_NOTIMPL
 The method is not implemented.

Remarks

When the IPrintOemDriverPS::DrvGetDriverSetting method is called, either a string pointer or a constant value can be specified for pFeatureKeyword.

  • If pFeatureKeyword is a string, it must represent a keyword argument to an *OpenUI entry in a Pscript5 minidriver's PPD file.

    The method should return one or more NULL-terminated strings in the buffer pointed to by pOutput. Each string should represent the name of a currently selected option. The number of strings should be returned in pdwOptionsReturned.

  • If pFeatureKeyword is a constant, it must be one of the OEMGDS_-prefixed constants defined in printoem.h. The method should return the value indicated by the specified constant by placing it in the buffer pointed to by pOutput. The value returned in pdwOptionsReturned must be 1.

Requirements

Requirement Value
Target Platform Desktop
Header prcomoem.h (include Prcomoem.h)