Método IPrintOemPS2::GetPDEVAdjustment (prcomoem.h)

Artículo
02/07/2025

El método IPrintOemPS2::GetPDEVAdjustment permite que un complemento invalide configuración de PDEV específica.

Sintaxis

HRESULT GetPDEVAdjustment(
        PDEVOBJ  pdevobj,
        DWORD    dwAdjustType,
        PVOID    pBuf,
        DWORD    cbBuffer,
  [out] OUT BOOL *pbAdjustmentDone
);

Parámetros

pdevobj

Puntero a una estructura DEVOBJ de.

dwAdjustType

Especifica el tipo de ajuste solicitado. Actualmente se admiten las marcas siguientes:

Bandera	Significado
PDEV_ADJUST_PAPER_MARGIN_TYPE	Ajuste la configuración del margen de papel que se notifica en el PDEV. Consulte la estructura PDEV_ADJUST_PAPER_MARGIN.
PDEV_HOSTFONT_ENABLED_TYPE	Habilite o deshabilite la característica de compatibilidad con Hostfont. Consulte la estructura PDEV_HOSTFONT_ENABLED.
PDEV_USE_TRUE_COLOR_TYPE	Habilite o deshabilite la salida de color para impresoras monocromáticas y de color. Consulte la estructura PDEV_USE_TRUE_COLOR.

pBuf

Puntero a una estructura que contiene la configuración planeada que se usa si no hay ningún cambio. Estas estructuras se enumeran en la tabla anterior. El complemento puede sobrescribir la configuración en la estructura pertinente.

cbBuffer

Especifica el tamaño, en bytes, de la estructura a la que apunta pBuf.

[out] pbAdjustmentDone

Puntero a una ubicación de memoria que el complemento establece en TRUE cuando realmente cambia un valor en el búfer. El controlador puede usar esto para las optimizaciones.

Valor devuelto

El método IPrintOemPS2::GetPDEVAdjustment debe devolver S_OK si reconoce el tipo de ajuste y S_FALSE si no lo hace. Si se produce un error en el método, debe devolver E_FAIL. Se llama a la cadena de complementos hasta que se S_OK o se devuelve un código de error distinto de E_NOTIMPL. Es decir, se llama a la cadena de complementos hasta que se encuentra el primer complemento que es capaz de controlar el ajuste.

Observaciones

Esta función está disponible en Windows XP y versiones posteriores.

Actualmente, el controlador Pscript5 llama a IPrintOemPS2::GetPDEVAdjustment para ajustar la configuración del margen de papel, como se indica en el PDEV, para habilitar o deshabilitar la característica Hostfont, o para activar o desactivar la salida de color postScript.