Função EngCopyBits (winddi.h)
A função EngCopyBits é convertida entre superfícies de raster gerenciadas pelo dispositivo e bitmaps de formato padrão GDI.
Sintaxe
ENGAPI BOOL EngCopyBits(
SURFOBJ *psoDest,
SURFOBJ *psoSrc,
CLIPOBJ *pco,
XLATEOBJ *pxlo,
[in] RECTL *prclDest,
[in] POINTL *pptlSrc
);
Parâmetros
psoDest
Ponteiro para uma estrutura SURFOBJ que descreve a superfície de destino da operação de cópia.
psoSrc
Ponteiro para uma estrutura SURFOBJ que descreve a superfície de origem da operação de cópia.
pco
Ponteiro para uma estrutura CLIPOBJ que restringe a área da superfície de destino que será afetada. Este parâmetro pode ser NULL.
pxlo
Ponteiro para uma estrutura XLATEOBJ que define a tradução de índices de cores entre as superfícies de origem e de destino.
[in] prclDest
Ponteiro para uma estrutura RECTL que define a área no sistema de coordenadas da superfície de destino que será modificada. O retângulo é exclusivo para o canto inferior direito, o que significa que as bordas inferior e direita desse retângulo não fazem parte da cópia.
[in] pptlSrc
Ponteiro para uma estrutura POINTL que define o canto superior esquerdo do retângulo de origem.
Retornar valor
O valor retornado será TRUE se a função for bem-sucedida. Se não for bem-sucedido, ele registrará um erro e retornará FALSE.
Comentários
Os bitmaps de formato padrão são um formato de plano único, de pixels empacotados. Cada linha de verificação é alinhada em um limite de 4 bytes. Esses bitmaps têm 1, 4, 8, 16, 24 ou 32 bits por pixel. Consulte a função EngCreateBitmap para obter uma lista de tipos de formato padrão.
A GDI chama essa função de suas simulações.
EngCopyBits não deve ser chamado com um retângulo de destino vazio e os dois pontos do retângulo de destino devem ser bem ordenados; ou seja, o primeiro ponto deve representar o vértice superior esquerdo do retângulo e o segundo deve representar o vértice inferior direito.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | winddi.h (inclua Winddi.h) |
| Biblioteca | Win32k.lib |
| DLL | Win32k.sys |