Compartir a través de

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

  • Artículo

Los minidrivers Unidrv y Pscript5 proporcionan el método IPrintOemDriverUI::DrvGetDriverSetting para que los complementos de interfaz de usuario 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 de OEMUIOBJ de.

Feature

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

Observaciones

Al llamar al método IPrintOemDriverUI::DrvGetDriverSetting, un complemento de interfaz de usuario puede especificar un puntero de cadena o un valor constante para pFeatureKeyword.

  • Si pFeatureKeyword es una cadena, debe representar una de las siguientes opciones:
    • Un nombre de característica especificado en un minidriver Unidrv de archivo GPD o,
    • Argumento de palabra clave para una entrada *OpenUI en un archivo PPD del minidriver Pscript5.

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

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

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de prcomoem.h (include Prcomoem.h)