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

El IPrintOemDriverUni::DrvGetDriverSetting controlador Unidrv 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

El autor de la llamada proporcionó un valor 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 IPrintOemDriverUni::DrvGetDriverSetting método , se puede especificar un puntero de cadena o un valor constante para pFeatureKeyword.

• Si pFeatureKeyword es una cadena, debe representar un nombre de característica especificado en un archivo GPD de minidriver Unidrv .

  El método debe devolver una o varias cadenas terminadas en NULL en el búfer a las 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 (incluya Prcomoem.h)