Função GetDeviceCaps (wingdi.h)
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 | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
A versão do driver do dispositivo. | ||||||||||||||||||||||||||||||||||
|
Tecnologia do dispositivo. Pode ser qualquer um dos valores a seguir.
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 . |
||||||||||||||||||||||||||||||||||
|
Largura, em milímetros, da tela física. | ||||||||||||||||||||||||||||||||||
|
Altura, em milímetros, da tela física. | ||||||||||||||||||||||||||||||||||
|
Largura, em pixels, da tela; ou para impressoras, a largura, em pixels, da área imprimível da página. | ||||||||||||||||||||||||||||||||||
|
Altura, em linhas de varredura, da tela; ou para impressoras, a altura, em pixels, da área imprimível da página. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
Número de bits de cor adjacentes para cada pixel. | ||||||||||||||||||||||||||||||||||
|
Número de planos de cores. | ||||||||||||||||||||||||||||||||||
|
Número de pincéis específicos do dispositivo. | ||||||||||||||||||||||||||||||||||
|
Número de canetas específicas do dispositivo. | ||||||||||||||||||||||||||||||||||
|
Número de fontes específicas do dispositivo. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
Largura relativa de um pixel de dispositivo usado para desenho de linha. | ||||||||||||||||||||||||||||||||||
|
Altura relativa de um pixel de dispositivo usado para desenho de linha. | ||||||||||||||||||||||||||||||||||
|
Largura diagonal do pixel do dispositivo usado para desenho de linha. | ||||||||||||||||||||||||||||||||||
|
Reservado. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
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. |
||||||||||||||||||||||||||||||||||
|
Fator de dimensionamento para o eixo x da impressora. | ||||||||||||||||||||||||||||||||||
|
Fator de dimensionamento para o eixo y da impressora. | ||||||||||||||||||||||||||||||||||
|
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. | ||||||||||||||||||||||||||||||||||
|
Valor que indica os recursos de sombreamento e mesclagem do dispositivo. Consulte Comentários para obter mais comentários.
|
||||||||||||||||||||||||||||||||||
|
Valor que indica os recursos de varredura do dispositivo, conforme mostrado na tabela a seguir.
|
||||||||||||||||||||||||||||||||||
|
Valor que indica os recursos de curva do dispositivo, conforme mostrado na tabela a seguir.
|
||||||||||||||||||||||||||||||||||
|
Valor que indica os recursos de linha do dispositivo, conforme mostrado na tabela a seguir:
|
||||||||||||||||||||||||||||||||||
|
Valor que indica os recursos de polígono do dispositivo, conforme mostrado na tabela a seguir.
|
||||||||||||||||||||||||||||||||||
|
Valor que indica os recursos de texto do dispositivo, conforme mostrado na tabela a seguir.
|
||||||||||||||||||||||||||||||||||
|
Valor que indica os recursos de gerenciamento de cores do dispositivo.
|
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.
Nota Display1 normalmente é o monitor primário, mas nem sempre.
| Í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 |
Confira também
Funções de contexto do dispositivo
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de