Método IPrintOemDriverPS::D rvGetDriverSetting (prcomoem.h)

El IPrintOemDriverPS::DrvGetDriverSetting controlador Pscript5 proporciona el método para que los complementos de representación puedan obtener el estado actual de las características de la impresora y otra información interna.

Sintaxis

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

Parámetros

pdriverobj

Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ .

Feature

Valor proporcionado por el autor de la llamada que identifica la característica de impresora para la que se devolverá la configuración de la opción. Puede ser un puntero de cadena o una constante, como se describe en la sección Comentarios siguiente.

pOutput

Puntero proporcionado por el autor de la llamada a un búfer para recibir la información especificada.

cbSize

Tamaño proporcionado por el autor de la llamada, en bytes, del búfer al que apunta pOutput.

pcbNeeded

Puntero proporcionado por el autor de la llamada a una ubicación para recibir el tamaño mínimo del búfer necesario para contener la información solicitada.

pdwOptionsReturned

Puntero proporcionado por el autor de la llamada a una ubicación para recibir el número de cadenas de opción colocadas en pOutput.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación
E_NOTIMPL	El método no está implementado.

Comentarios

Cuando se llama al IPrintOemDriverPS::DrvGetDriverSetting método , se puede especificar un puntero de cadena o un valor constante para pFeatureKeyword.

• Si pFeatureKeyword es una cadena, debe representar un argumento de palabra clave en una entrada *OpenUI en un archivo PPD del minidriver de Pscript5.

  El método debe devolver una o varias cadenas terminadas en NULL en el búfer al que apunta pOutput. Cada cadena debe representar el nombre de una opción seleccionada actualmente. El número de cadenas debe devolverse en pdwOptionsReturned.

• Si pFeatureKeyword es una constante, debe ser una de las constantes con prefijo OEMGDS_ definidas en printoem.h. El método debe devolver el valor indicado por la constante especificada colocándolo en el búfer al que apunta pOutput. El valor devuelto en pdwOptionsReturned debe ser 1.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)