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

Artigo
02/07/2025

O método IPrintOemUni3::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 sinalizadores a seguir.

Bandeira	Significado
PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE	Ajuste a configuração de resolução gráfica relatada na estrutura PDEV. Para obter mais informações, consulte a estrutura PDEV_ADJUST_GRAPHICS RESOLUTION.
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Ajuste a área de origem imagens relatada na estrutura PDEV. Para obter mais informações, consulte a estrutura de PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA.
PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE	Ajuste o tamanho do papel físico relatado na estrutura PDEV. Para obter mais informações, consulte a estrutura de PDEV_ADJUST_PAPER_PHYSICAL_SIZE.

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 IPrintOemUni3::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 Vista e posterior.

Atualmente, o driver Unidrv chama IPrintOemUni3::GetPDEVAdjustment para ajustar a configuração de resolução gráfica, conforme relatado no PDEV, para ajustar a área de origem imagens ou ajustar o tamanho do papel físico.