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

Artigo
02/29/2024

O IPrintOemUni3::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. Atualmente, há suporte para os sinalizadores a seguir.

Sinalizador	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 de imagem relatada na estrutura PDEV. Para obter mais informações, consulte a estrutura 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 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 pelo pBuf.

[out] pbAdjustmentDone

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

Retornar valor

O IPrintOemUni3::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 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 para ajustar o tamanho do papel físico.