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

Artículo
08/07/2023

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

Sintaxis

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

Parámetros

pci

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

Feature

Valor proporcionado por el autor de la llamada que identifica la característica de impresora para la que se devuelven los valores de 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

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

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

Este método se hereda de la interfaz COM IPrintOemDriverUI y solo se puede llamar a él por los complementos de interfaz de usuario de Pscript5 y Windows XP y versiones posteriores que no reemplazan por completo las páginas de interfaz de usuario estándar del controlador principal y se admiten durante las rutinas de devolución de llamada de IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets y sus rutinas de devolución de llamada de hoja de propiedades. Cuando se admite este método, tiene el mismo comportamiento que IPrintOemDriverUI::D rvGetDriverSetting. Cuando no se admite, este método debe devolver E_NOTIMPL.