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

Artigo
02/07/2025

O método IPrintOemPS2::GetPDEVAdjustment permite que um plug-in substitua configurações de PDEV específicas.

Sintaxe

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

Parâmetros

pdevobj

Ponteiro para uma estrutura de DEVOBJ.

dwAdjustType

Especifica o tipo de ajuste solicitado. No momento, há suporte para os seguintes sinalizadores:

Bandeira	Significado
PDEV_ADJUST_PAPER_MARGIN_TYPE	Ajuste a configuração de margem de papel relatada no PDEV. Consulte a estrutura de PDEV_ADJUST_PAPER_MARGIN.
PDEV_HOSTFONT_ENABLED_TYPE	Habilite ou desabilite o recurso de suporte do Hostfont. Consulte a estrutura de PDEV_HOSTFONT_ENABLED.
PDEV_USE_TRUE_COLOR_TYPE	Habilitar ou desabilitar a saída de cores para impressoras monocromáticas e coloridas. Consulte a estrutura de PDEV_USE_TRUE_COLOR.

pBuf

Ponteiro para uma estrutura que contém as configurações planejadas que são usadas se não houver nenhuma alteração. Essas estruturas são listadas na tabela anterior. O plug-in pode substituir as configurações na estrutura relevante.

cbBuffer

Especifica o tamanho, em bytes, da estrutura apontada por pBuf.

[out] pbAdjustmentDone

Ponteiro para um local de memória que o plug-in define como VERDADEIRO quando ele realmente altera um valor no buffer. Isso pode ser usado pelo driver para otimizações.

Valor de retorno

O método IPrintOemPS2::GetPDEVAdjustment deverá retornar S_OK se reconhecer o tipo de ajuste e S_FALSE se não o fizer. Se o método falhar, ele deverá retornar E_FAIL. A cadeia de plug-ins é chamada até que S_OK ou um código de falha diferente de E_NOTIMPL seja retornado. Ou seja, a cadeia de plug-ins é chamada até que o primeiro plug-in capaz de lidar com o ajuste seja encontrado.

Observações

Essa função está disponível no Windows XP e posterior.

Atualmente, o driver Pscript5 chama IPrintOemPS2::GetPDEVAdjustment para ajustar a configuração de margem de papel, conforme relatado no PDEV, para habilitar ou desabilitar o recurso Hostfont ou ativar ou desativar a saída de cor do PostScript.