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

  • Artículo

El IPrintOemUni3::SetBandSize método 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 se requieren. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
BMF_1BPP
 Monocromático
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 no proporcionado por Unidrv que especifica el ancho del área de impresión, en bytes.

[in] dwPageHeight

Valor no proporcionado por 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. Vea la Nota.
E_FAIL
 Error en la operación. Vea la Nota.
E_NOTIMPL
 Unidrv debe calcular el tamaño de banda.

Comentarios

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 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 calculada multiplicando dwPageWidthBytes por *pdwRequiredHeight. Si el complemento de representación admite el método IPrintOemUni::D riverDMS y ese método devuelve "S_OK", IPrintOemUni3::SetBandSize no se llama a .

Si se define este método y el archivo genérico de la impresora (GPD) indica que el preanalysis 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 , vea Infraestructura de análisis previo.

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

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado prcomoem.h (include Prcomoem.h)