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

Artigo
02/26/2024

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

Sintaxe

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

Parâmetros

pdevobj

Ponteiro para uma estrutura DEVOBJ .

dwAdjustType

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

Sinalizador	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	Habilite ou desabilite 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 pelo pBuf.

[out] pbAdjustmentDone

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

Retornar valor

O IPrintOemPS2::GetPDEVAdjustment método 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.

Comentários

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 para ativar ou desativar a saída de cor do PostScript.