Compartir a través de

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

  • Artículo

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

Feature

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

Al llamar al IPrintOemDriverUI::DrvGetDriverSetting método , 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 archivo GPD de minidriver Unidrv , o bien,
    • 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 a las 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 con prefijo OEMGDS_ 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 Value
Plataforma de destino Escritorio
Encabezado prcomoem.h (incluya Prcomoem.h)