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

Artículo
08/07/2023

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

Sintaxis

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

Parámetros

pdevobj

Puntero a una estructura DEVOBJ .

dwAdjustType

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

Marca	Significado
PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE	Ajuste el valor de resolución de gráficos que se notifica en la estructura PDEV. Para obtener más información, vea la estructura PDEV_ADJUST_GRAPHICS RESOLUTION .
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 de papel físico que se notifica en la estructura PDEV. Para obtener más información, vea la estructura 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 IPrintOemUni3::GetPDEVAdjustment método 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 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 capaz de controlar el ajuste.

Comentarios

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

Actualmente, el controlador Unidrv llama IPrintOemUni3::GetPDEVAdjustment a 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 crear la imagen o para ajustar el tamaño del papel físico.