Função MxdcGetPDEVAdjustment (mxdc.h)

A função MxdcGetPDEVAdjustment é exportada por uma DLL de interface de impressora e fornece dados de configuração da impressora para o MXDC (Conversor de Documentos do Microsoft XPS).

Sintaxe

HRESULT MxdcGetPDEVAdjustment(
  [in]           HANDLE                    hPrinter,
  [in]           ULONG                     cbDevMode,
  [in]           const DEVMODE             *pDevMode,
  [in]           ULONG                     cbIn,
  [in, optional] const VOID                *pvIn,
  [in]           ULONG                     cbPrintPropertiesCollection,
                 PrintPropertiesCollection *pPrintPropertiesCollection
);

Parâmetros

[in] hPrinter

O identificador da impressora instanciada no momento.

[in] cbDevMode

O tamanho da estrutura DEVMODE , em bytes, incluindo os dados DEVMODE privados do driver.

[in] pDevMode

Uma cópia da estrutura DEVMODE que o MXDC recebeu. A DLL da interface da impressora usa informações dessa estrutura para retornar os dados solicitados.

[in] cbIn

Um parâmetro de entrada que designa o tamanho do parâmetro pvIn , em bytes. Atualmente, esse parâmetro não é usado e seu valor é zero.

[in, optional] pvIn

Um parâmetro que consiste em dados enviados para a DLL da interface da impressora do MXDC. Atualmente, esse parâmetro não é usado e seu valor é NULL.

[in] cbPrintPropertiesCollection

O tamanho da estrutura de dados PrintPropertiesCollection , em bytes.

pPrintPropertiesCollection

A estrutura de dados PrintPropertiesCollection da qual a DLL da interface da impressora obtém os dados solicitados. Essa estrutura é definida em WinSpool.h. Os campos solicitados podem ser preenchidos previamente com os dados padrão do MXDC. A DLL da interface da impressora deve ignorar os campos que ela não entende.

Retornar valor

MxdcGetPDEVAdjustment deve retornar um dos seguintes valores:

Código de retorno	Descrição
S_OK	A DLL da interface da impressora retornou com êxito uma área imagens ajustada, um tipo de compactação ou um DPI com base na estrutura DEVMODE fornecida. O MXDC validará a área imagens retornada e a usará para preencher a estrutura GDIINFO nos respectivos campos.
E_NOTIMPL	A função MxdcGetPDEVAdjustment não é implementada pela interface da impressora. A interface da impressora não deve modificar os campos aos quais não dá suporte. O MXDC usa como padrão seus padrões atuais. Para o caso de área imagens, o MXDC usa como padrão o uso do tamanho da página física. Para a opção de compactação, o MXDC usa como padrão a compactação JPEG média.
E_FAIL	Para esse valor ou qualquer outro valor de falha, o MXDC retorna -1 para a função DrvEnablePDEV , captura a exceção interna e define um sinalizador para falhar e encerrar o trabalho de impressão.

Comentários

A função MxdcGetPDEVAdjustment é implementada pelo fornecedor de hardware. O MXDC chama essa função para obter dados de configuração da impressora na forma de um recipiente de propriedades que inclui os seguintes dados:

O MXDC permite que a DLL da interface da impressora ajuste o DPI por meio da função MxdcGetPDEVAdjustment somente se o campo dmPrintQuality do trabalho de impressão tiver um valor menor ou igual a 0. Se o valor de DPI não for ajustado, o MXDC mapeará valores dmPrintQuality negativos para as resoluções a seguir.

Nome da GDI (Wingdi.h)	Valor GDI(Wingdi.h)	Interpretação padrão do MXDC(pontos por polegada)
DMRES_HIGH	-4	2400
DMRES_MEDIUM	-3	1200
DMRES_LOW	-2	600
DMRES_DRAFT	-1	400

O nome da propriedade MXDC que armazena o valor de DPI padrão MXDC é L"MxdcDotsPerInch".

A tabela a seguir lista os tipos de propriedade do MXDC e os campos do recipiente de propriedades para as propriedades:

Propriedade (propertyName)	Tipo de propriedade (ePropertyValue)	Campos de recipiente de propriedades
L"MxdcImageableArea"	kPropertyTypeBuffer	PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyBlob.cbBuf = sizeof(RECT) PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyBlob.pBuf
L"MxdcImageCompressionType"	kPropertyTypeInt32	PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyInt32
L"MxdcDotsPerInch"	kPropertyTypeInt32	PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyInt32
L"MxdcLandscapeRotation"	kPropertyTypeInt32	PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyInt32

A tabela a seguir lista os tipos de dados e os valores de dados com suporte do MXDC para as propriedades:

Propriedade (propertyName)	Tipos e valores de dados
L"MxdcImageableArea"	Tipo de dados: RECT Valores: RECT::left (o mesmo que FORM_INFO_1) RECT::right (o mesmo que FORM_INFO_1) RECT::top (o mesmo que FORM_INFO_1) RECT::bottom (o mesmo que FORM_INFO_1)
L"MxdcImageCompressionType"	Tipo de dados: LONG Valores: 1 = Alta Compactação JPEG 2 = Compactação média JPEG 3 = Baixa compactação JPEG 4 = Compactação PNG
L"MxdcDotsPerInch"	Tipo de dados: LONG Valores: Um valor positivo para Pontos por Polegada
L"MxdcLandscapeRotation"	Tipo de dados: LONG Valores: 90 = MXDC_LANDSCAPE_ROTATE_COUNTERCLOCKWISE_90_DEGREES 0 = MXDC_LANDSCAPE_ROTATE_NONE -90 = MXDC_LANDSCAPE_ROTATE_COUNTERCLOCKWISE_270_DEGREES

A função MxdcGetPDEVAdjustment não faz parte do MXDC. O MXDC chama essa função na DLL de configuração do driver para obter dados para configurar a impressora.

O MXDC espera que a área imagens seja expressa em coordenadas não detalhadas (orientação retrato). O MXDC gira o tamanho da página e a área imagens de acordo com o valor do membro dmOrientation da estrutura DEVMODE apontada por pDevMode. Assim, a implementação do MxdcGetPDEVAdjustment pelo fornecedor de hardware deve evitar especificar a área imagens em coordenadas giradas (orientação paisagem), pois isso fará com que os trabalhos de impressão paisagem sejam impressos incorretamente.

O valor padrão no MXDC será MXDC_LANDSCAPE_ROTATE_COUNTERCLOCKWISE_270_DEGREES, que é seu comportamento herdado atual.

Toda a rotação será feita na área imagens. Se um componente de configuração (UniDrv/PostScript, XPSDrv Monolithic) não entender os novos valores do recipiente de propriedades, ele deverá ignorá-los como está no design atual.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	mxdc.h (inclua Mxdc.h)

Confira também

DrvEnablePDEV

GDIINFO

IPrintOemUIMXDC Interface