Função EngCreateBitmap (winddi.h)
A função EngCreateBitmap solicita que a GDI crie e gerencie um bitmap.
Sintaxe
ENGAPI HBITMAP EngCreateBitmap(
SIZEL sizl,
LONG lWidth,
[in] ULONG iFormat,
[in] FLONG fl,
[in] PVOID pvBits
);
Parâmetros
sizl
Especifica uma estrutura SIZEL cujos membros contêm a largura e a altura, em pixels, do bitmap a ser criado. Uma estrutura SIZEL é idêntica a uma estrutura SIZE .
Se pvBits não for NULL, esse valor deverá representar todos os pixels visíveis no dispositivo, permitindo que o dispositivo mantenha a memória fora da tela.
lWidth
Especifica a largura de alocação do bitmap, que é o número de bytes que devem ser adicionados a um ponteiro para mover uma linha de verificação para baixo.
[in] iFormat
Especifica o formato do bitmap em termos do número de bits de informações de cor por pixel necessários. Esse parâmetro pode usar um dos valores a seguir:
| Valor | Significado |
|---|---|
| BMF_1BPP | Monocromático |
| BMF_4BPP | 4 bits por pixel |
| BMF_8BPP | 8 bits por pixel |
| BMF_16BPP | 16 bits por pixel |
| BMF_24BPP | 24 bits por pixel |
| BMF_32BPP | 32 bits por pixel |
| BMF_4RLE | 4 bits por pixel; comprimento de execução codificado |
| BMF_8RLE | 8 bits por pixel; comprimento de execução codificado |
[in] fl
É uma máscara de bits que especifica propriedades sobre o bitmap a ser criado. Esse parâmetro pode ser zero ou qualquer combinação dos seguintes valores:
| Valor | Significado |
|---|---|
| BMF_NOZEROINIT | A GDI não inicializará zero o bitmap ao alocá-lo. Esse sinalizador é verificado somente quando pvBits é NULL. |
| BMF_TOPDOWN | A primeira linha de verificação representa a parte superior do bitmap. Observe que bitmaps de formato padrão têm a primeira linha de verificação na parte inferior por padrão. |
| BMF_USERMEM | A GDI alocará a memória para o bitmap da memória do usuário. Por padrão, a memória é alocada do espaço de endereço do kernel. Esse sinalizador deve ser especificado somente quando o bitmap que está sendo criado não será usado por outros processos. A memória do usuário não pode ser passada para EngWritePrinter pelo driver da impressora. |
[in] pvBits
Ponteiro para a primeira linha de verificação do bitmap que deve ser criado. Se esse parâmetro for NULL, a GDI alocará o espaço de armazenamento para os pixels do bitmap. Se pvBits não for NULL, será um ponteiro para o buffer para o bitmap.
Valor retornado
Se a função for concluída com êxito, o valor retornado será um identificador que identifica o bitmap criado. Caso contrário, o valor retornado será 0. EngCreateBitmap não registra um código de erro.
Comentários
Opcionalmente, o armazenamento para o bitmap pode ser fornecido pelo driver.
O driver deve associar o bitmap criado como uma superfície chamando EngAssociateSurface antes de retornar de DrvEnableSurface.
O bitmap deve ser excluído usando EngDeleteSurface quando não for mais necessário.
Os drivers de exibição do buffer de quadro devem usar o parâmetro pvBits , permitindo que a GDI faça a maioria dos desenhos diretamente na exibição.
Requisitos
| 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 |