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

Artículo
02/07/2025

El método IPrintOemUni3::SetBandSize se puede usar con impresoras compatibles con Unidrv para especificar el tamaño de banda deseado en la salida impresa.

Sintaxis

HRESULT SetBandSize(
  [in] PDEVOBJ pdevobj,
  [in] INT     iFormat,
  [in] DWORD   dwPageWidthBytes,
  [in] DWORD   dwPageHeight,
  [in] DWORD   dwMaxHeight,
  [in] PDWORD  pdwRequiredHeight
);

Parámetros

[in] pdevobj

Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ.

[in] iFormat

Valor entero que especifica el formato del mapa de bits en términos del número de bits de información de color por píxel que son necesarios. Este parámetro puede ser uno de los siguientes valores.

Valor	Significado
BMF_1BPP	Monocromo
BMF_4BPP	4 bits por píxel
BMF_8BPP	8 bits por píxel
BMF_16BPP	16 bits por píxel
BMF_24BPP	24 bits por píxel
BMF_32BPP	32 bits por píxel
BMF_4RLE	4 bits por píxel; longitud de ejecución codificada
BMF_8RLE	8 bits por píxel; longitud de ejecución codificada

[in] dwPageWidthBytes

Valor proporcionado por Unidrv que especifica el ancho del área de impresión, en bytes.

[in] dwPageHeight

Valor proporcionado unidrv que especifica el alto del área de impresión, en píxeles.

[in] dwMaxHeight

Valor no proporcionado por Unidrv que especifica el alto máximo permitido del área de impresión, en píxeles.

[in] pdwRequiredHeight

Puntero proporcionado por el autor de la llamada a un DWORD que contiene el alto del área de impresión, en píxeles, requerido por el complemento de representación.

Valor devuelto

El método debe devolver uno de los siguientes valores:

Código devuelto	Descripción
S_OK	La operación se realizó correctamente. Consulte Nota.
E_FAIL	Error en la operación. Consulte Nota.
E_NOTIMPL	Unidrv debe calcular el tamaño de banda.

Observaciones

Este método está disponible en Windows Vista y versiones posteriores.

Este método lo usa un complemento de representación para especificar el tamaño de banda mediante los propios cálculos del complemento, en lugar de usar los cálculos de tamaño de banda de Unidrv.

Puede deshabilitar las operaciones de bandas mediante Unidrv estableciendo el valor de dwPageHeight en *pdwRequiredHeight, pero debe tener en cuenta el efecto de rendimiento del valor de alto que solicita el complemento de representación. Para la representación, Unidrv necesita al menos la cantidad de memoria que se calcula multiplicando dwPageWidthBytes por *pdwRequiredHeight. Si el complemento de representación admite el método IPrintOemUni::D riverDMS y ese método devuelve "S_OK", no se llama a IPrintOemUni3::SetBandSize.

Si se define este método y el archivo de descripción genérica de la impresora (GPD) indica que el análisis previo está deshabilitado (el archivo GPD incluye "*PreAnalysisOptions: 0"), Unidrv llama a este método para calcular el tamaño de banda. Para obtener información sobre el atributo preAnalysisOptions de, consulte infraestructura de análisis previo.

Si el complemento de representación admite IPrintOemUni::D riverDMS y ese método devuelve S_OK, no se llama a IPrintOemUni3::SetBandSize.

Requisitos

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

Compartir a través de