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) |