Função GetDeviceCaps (wingdi.h)

Artigo
06/01/2023

A função GetDeviceCaps recupera informações específicas do dispositivo para o dispositivo especificado.

Sintaxe

int GetDeviceCaps(
  [in] HDC hdc,
  [in] int index
);

Parâmetros

[in] hdc

Um identificador para o controlador de domínio.

[in] index

O item a ser retornado. Esse parâmetro pode usar um dos valores a seguir.

Índice

Significado

DRIVERVERSION

A versão do driver do dispositivo.

TECNOLOGIA

Tecnologia do dispositivo. Pode ser qualquer um dos valores a seguir.

DT_PLOTTER	Plotador de vetor
DT_RASDISPLAY	Exibição de varredura
DT_RASPRINTER	Impressora raster
DT_RASCAMERA	Câmera de varredura
DT_CHARSTREAM	Fluxo de caracteres
DT_METAFILE	Metarquivo
DT_DISPFILE	Exibir arquivo

Se o parâmetro hdc for um identificador para o DC de um meta-arquivo aprimorado, a tecnologia do dispositivo será a do dispositivo referenciado, conforme especificado para a função CreateEnhMetaFile . Para determinar se é um DC de meta-arquivo aprimorado, use a função GetObjectType .

HORZSIZE

Largura, em milímetros, da tela física.

VERTSIZE

Altura, em milímetros, da tela física.

HORZRES

Largura, em pixels, da tela; ou para impressoras, a largura, em pixels, da área imprimível da página.

VERTRES

Altura, em linhas de varredura, da tela; ou para impressoras, a altura, em pixels, da área imprimível da página.

LOGPIXELSX

Número de pixels por polegada lógica ao longo da largura da tela. Em um sistema com vários monitores de exibição, esse valor é o mesmo para todos os monitores.

LOGPIXELSY

Número de pixels por polegada lógica ao longo da altura da tela. Em um sistema com vários monitores de exibição, esse valor é o mesmo para todos os monitores.

BITSPIXEL

Número de bits de cor adjacentes para cada pixel.

AVIÕES

Número de planos de cores.

NUMBRUSHES

Número de pincéis específicos do dispositivo.

NUMPENS

Número de canetas específicas do dispositivo.

NUMFONTS

Número de fontes específicas do dispositivo.

NUMCOLORS

Número de entradas na tabela de cores do dispositivo, se o dispositivo tiver uma profundidade de cor de no máximo 8 bits por pixel. Para dispositivos com maiores profundidades de cor, -1 é retornado.

ASPECTX

Largura relativa de um pixel de dispositivo usado para desenho de linha.

ASPECTO

Altura relativa de um pixel de dispositivo usado para desenho de linha.

ASPECTXY

Largura diagonal do pixel do dispositivo usado para desenho de linha.

PDEVICESIZE

Reservado.

CLIPCAPS

Sinalizador que indica os recursos de recorte do dispositivo. Se o dispositivo puder recortar para um retângulo, ele será 1. Caso contrário, é 0.

SIZEPALETTE

Número de entradas na paleta do sistema. Esse índice só será válido se o driver de dispositivo definir o RC_PALETTE bit no índice RASTERCAPS e estiver disponível somente se o driver for compatível com o Windows de 16 bits.

NUMRESERVED

Número de entradas reservadas na paleta do sistema. Esse índice só será válido se o driver de dispositivo definir o RC_PALETTE bit no índice RASTERCAPS e estiver disponível somente se o driver for compatível com o Windows de 16 bits.

COLORRES

Resolução real de cores do dispositivo, em bits por pixel. Esse índice só será válido se o driver de dispositivo definir o RC_PALETTE bit no índice RASTERCAPS e estiver disponível somente se o driver for compatível com o Windows de 16 bits.

PHYSICALWIDTH

Para dispositivos de impressão: a largura da página física, em unidades de dispositivo. Por exemplo, uma impressora definida para imprimir a 600 dpi em papel de 8,5-x11 polegadas tem um valor de largura física de 5100 unidades de dispositivo. Observe que a página física é quase sempre maior que a área imprimível da página e nunca menor.

PHYSICALHEIGHT

Para dispositivos de impressão: a altura da página física, em unidades de dispositivo. Por exemplo, uma impressora definida para imprimir a 600 dpi em papel de 8,5 por 11 polegadas tem um valor de altura física de 6.600 unidades de dispositivo. Observe que a página física é quase sempre maior que a área imprimível da página e nunca menor.

PHYSICALOFFSETX

Para imprimir dispositivos: a distância da borda esquerda da página física até a borda esquerda da área imprimível, em unidades de dispositivo. Por exemplo, uma impressora definida para imprimir a 600 dpi em papel de 8,5 por 11 polegadas, que não pode imprimir no papel de 0,25 polegadas mais à esquerda, tem um deslocamento físico horizontal de 150 unidades de dispositivo.

PHYSICALOFFSETY

Para imprimir dispositivos: a distância da borda superior da página física até a borda superior da área imprimível, em unidades de dispositivo. Por exemplo, uma impressora definida para imprimir a 600 dpi em papel de 8,5 por 11 polegadas, que não pode imprimir no máximo 0,5 polegada de papel, tem um deslocamento físico vertical de 300 unidades de dispositivo.

VREFRESH

Para dispositivos de exibição: a taxa de atualização vertical atual do dispositivo, em ciclos por segundo (Hz).

Um valor de taxa de atualização vertical de 0 ou 1 representa a taxa de atualização padrão do hardware de exibição. Normalmente, essa taxa padrão é definida por opções em um cartão de exibição ou placa-mãe do computador ou por um programa de configuração que não usa funções de exibição, como ChangeDisplaySettings.

SCALINGFACTORX

Fator de dimensionamento para o eixo x da impressora.

SCALINGFACTORY

Fator de dimensionamento para o eixo y da impressora.

BLTALIGNMENT

Alinhamento de desenho horizontal preferencial, expresso como um múltiplo de pixels. Para obter o melhor desempenho de desenho, as janelas devem ser alinhadas horizontalmente a um múltiplo desse valor. Um valor zero indica que o dispositivo está acelerado e qualquer alinhamento pode ser usado.

SHADEBLENDCAPS

Valor que indica os recursos de sombreamento e mesclagem do dispositivo. Consulte Comentários para obter mais comentários.

SB_CONST_ALPHA	Manipula o membro SourceConstantAlpha da estrutura BLENDFUNCTION , que é referenciada pelo parâmetro blendFunction da função AlphaBlend .
SB_GRAD_RECT	Capaz de fazer retângulos GradientFill .
SB_GRAD_TRI	Capaz de fazer triângulos GradientFill .
SB_NONE	O dispositivo não dá suporte a nenhum desses recursos.
SB_PIXEL_ALPHA	Capaz de lidar com alfa por pixel em AlphaBlend.
SB_PREMULT_ALPHA	Capaz de lidar com alfa pré-multiplicado em AlphaBlend.

RASTERCAPS

Valor que indica os recursos de varredura do dispositivo, conforme mostrado na tabela a seguir.

RC_BANDING	Requer suporte para faixas.
RC_BITBLT	Capaz de transferir bitmaps.
RC_BITMAP64	Capaz de dar suporte a bitmaps maiores que 64 KB.
RC_DI_BITMAP	Capaz de dar suporte às funções SetDIBits e GetDIBits .
RC_DIBTODEV	Capaz de dar suporte à função SetDIBitsToDevice .
RC_FLOODFILL	Capaz de executar preenchimentos de inundação.
RC_PALETTE	Especifica um dispositivo baseado em paleta.
RC_SCALING	Capaz de dimensionar.
RC_STRETCHBLT	Capaz de executar a função StretchBlt .
RC_STRETCHDIB	Capaz de executar a função StretchDIBits .

CURVECAPS

Valor que indica os recursos de curva do dispositivo, conforme mostrado na tabela a seguir.

CC_NONE	O dispositivo não dá suporte a curvas.
CC_CHORD	O dispositivo pode desenhar arcos de acordes.
CC_CIRCLES	O dispositivo pode desenhar círculos.
CC_ELLIPSES	O dispositivo pode desenhar reticências.
CC_INTERIORS	O dispositivo pode desenhar interiores.
CC_PIE	O dispositivo pode desenhar cunhas de pizza.
CC_ROUNDRECT	O dispositivo pode desenhar retângulos arredondados.
CC_STYLED	O dispositivo pode desenhar bordas estilizadas.
CC_WIDE	O dispositivo pode desenhar bordas largas.
CC_WIDESTYLED	O dispositivo pode desenhar bordas largas e estilizadas.

LINECAPS

Valor que indica os recursos de linha do dispositivo, conforme mostrado na tabela a seguir:

LC_NONE	O dispositivo não dá suporte a linhas.
LC_INTERIORS	O dispositivo pode desenhar interiores.
LC_MARKER	O dispositivo pode desenhar um marcador.
LC_POLYLINE	O dispositivo pode desenhar uma polilinha.
LC_POLYMARKER	O dispositivo pode desenhar vários marcadores.
LC_STYLED	O dispositivo pode desenhar linhas estilizadas.
LC_WIDE	O dispositivo pode desenhar linhas largas.
LC_WIDESTYLED	O dispositivo pode desenhar linhas largas e estilizadas.

POLYGONALCAPS

Valor que indica os recursos de polígono do dispositivo, conforme mostrado na tabela a seguir.

PC_NONE	O dispositivo não dá suporte a polígonos.
PC_INTERIORS	O dispositivo pode desenhar interiores.
PC_POLYGON	O dispositivo pode desenhar polígonos de preenchimento alternativo.
PC_RECTANGLE	O dispositivo pode desenhar retângulos.
PC_SCANLINE	O dispositivo pode desenhar uma única linha de verificação.
PC_STYLED	O dispositivo pode desenhar bordas estilizadas.
PC_WIDE	O dispositivo pode desenhar bordas largas.
PC_WIDESTYLED	O dispositivo pode desenhar bordas largas e estilizadas.
PC_WINDPOLYGON	O dispositivo pode desenhar polígonos de preenchimento sinuoso.

TEXTCAPS

Valor que indica os recursos de texto do dispositivo, conforme mostrado na tabela a seguir.

TC_OP_CHARACTER	O dispositivo é capaz de precisão de saída de caractere.
TC_OP_STROKE	O dispositivo é capaz de obter precisão de saída de traço.
TC_CP_STROKE	O dispositivo é capaz de obter precisão de recorte de traço.
TC_CR_90	O dispositivo é capaz de rotação de caracteres de 90 graus.
TC_CR_ANY	O dispositivo é capaz de qualquer rotação de caracteres.
TC_SF_X_YINDEP	O dispositivo pode ser dimensionado independentemente nas direções x e y.
TC_SA_DOUBLE	O dispositivo é capaz de dobrar o caractere para dimensionamento.
TC_SA_INTEGER	O dispositivo usa múltiplos inteiros apenas para dimensionamento de caracteres.
TC_SA_CONTIN	O dispositivo usa múltiplos para dimensionamento exato de caracteres.
TC_EA_DOUBLE	O dispositivo pode desenhar caracteres de peso duplo.
TC_IA_ABLE	O dispositivo pode itálico.
TC_UA_ABLE	O dispositivo pode sublinhar.
TC_SO_ABLE	O dispositivo pode desenhar strikeouts.
TC_RA_ABLE	O dispositivo pode desenhar fontes de varredura.
TC_VA_ABLE	O dispositivo pode desenhar fontes de vetor.
TC_RESERVED	Reservados; deve ser zero.
TC_SCROLLBLT	O dispositivo não pode rolar usando uma transferência de bloco de bits. Observe que esse significado pode ser o oposto do que você espera.

COLORMGMTCAPS

Valor que indica os recursos de gerenciamento de cores do dispositivo.

CM_CMYK_COLOR	O dispositivo pode aceitar o perfil de cor DO ICC de espaço de cor CMYK.
CM_DEVICE_ICM	O dispositivo pode executar o ICM no driver do dispositivo ou no próprio dispositivo.
CM_GAMMA_RAMP	O dispositivo dá suporte a GetDeviceGammaRamp e SetDeviceGammaRamp
CM_NONE	O dispositivo não dá suporte ao ICM.

Retornar valor

O valor retornado especifica o valor do item desejado.

Quando nIndex é BITSPIXEL e o dispositivo tem 15bpp ou 16bpp, o valor retornado é 16.

Comentários

Quando nIndex é SHADEBLENDCAPS:

Para uma impressora, GetDeviceCaps retorna o que a impressora relata.
Para um dispositivo de exibição, todas as operações de mesclagem estão disponíveis; além de SB_NONE, os únicos valores retornados são SB_CONST_ALPHA e SB_PIXEL_ALPHA, que indicam se essas operações são aceleradas.

Em um sistema de vários monitores, se hdc for a área de trabalho, GetDeviceCaps retornará os recursos do monitor primário. Se você quiser informações para outros monitores, deverá usar as APIs de vários monitores ou CreateDC para obter um HDC para o DC (contexto do dispositivo) de um monitor específico.

Nota Display1 normalmente é o monitor primário, mas nem sempre.

GetDeviceCaps fornece os seis índices a seguir no lugar de escapes de impressora.

Índice	Escape da impressora substituído
PHYSICALWIDTH	GETPHYSPAGESIZE
PHYSICALHEIGHT	GETPHYSPAGESIZE
PHYSICALOFFSETX	GETPRINTINGOFFSET
PHYSICALOFFSETY	GETPHYSICALOFFSET
SCALINGFACTORX	GETSCALINGFACTOR
SCALINGFACTORY	GETSCALINGFACTOR

ObservaçãoGetDeviceCaps relata informações que o driver de exibição fornece. Se o driver de exibição se recusar a relatar qualquer informação, GetDeviceCaps calculará as informações com base em cálculos fixos. Se o driver de exibição relatar informações inválidas, GetDeviceCaps retornará as informações inválidas. Além disso, se o driver de exibição se recusar a relatar informações, GetDeviceCaps poderá calcular informações incorretas porque pressupõe um DPI fixo (96 DPI) ou um tamanho fixo (dependendo das informações que o driver de vídeo fez e não forneceu). Infelizmente, um driver de exibição implementado no WDDM (Modelo de Driver de Exibição do Windows) (introduzido no Windows Vista) faz com que a GDI não obtenha as informações, portanto, GetDeviceCaps deve sempre calcular as informações.

Exemplos

Para obter um exemplo, consulte Preparando para imprimir.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll