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

Artículo
02/07/2025

El método IPrintOemUni3::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_GRAPHICS_RESOLUTION_TYPE	Ajuste la configuración de resolución de gráficos que se notifica en la estructura PDEV. Para obtener más información, consulte la estructura resolution de PDEV_ADJUST_GRAPHICS.
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Ajuste el área de origen que se puede ver en la estructura PDEV. Para obtener más información, consulte la estructura PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA.
PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE	Ajuste el tamaño del papel físico que se notifica en la estructura PDEV. Para obtener más información, consulte la estructura de PDEV_ADJUST_PAPER_PHYSICAL_SIZE.

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 IPrintOemUni3::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 Vista y versiones posteriores.

Actualmente, el controlador Unidrv llama a IPrintOemUni3::GetPDEVAdjustment para ajustar la configuración de resolución de gráficos, como se indica en el PDEV, para ajustar el área de origen que se puede ver o para ajustar el tamaño del papel físico.