Compartilhar via


Função EngCreateDeviceBitmap (winddi.h)

A função EngCreateDeviceBitmap solicita gdi para criar um identificador para um bitmap do dispositivo.

Sintaxe

ENGAPI HBITMAP EngCreateDeviceBitmap(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

Parâmetros

[in] dhsurf

Identificador de dispositivo para o bitmap do dispositivo a ser criado.

[in] sizl

Especifica uma estrutura SIZEL que contém a largura e a altura do bitmap a ser criado. Os membros cx e cy dessa estrutura contêm respectivamente, a largura e a altura do bitmap, em pixels. Uma estrutura SIZEL é idêntica a uma estrutura SIZE .

iFormatCompat

Especifica o formato do mecanismo compatível da superfície do dispositivo que está sendo criada. Isso será usado pela GDI se um buffer temporário for necessário para simular uma chamada de desenho complicada. Os valores permitidos para iFormatCompat são BMF_1BPP, BMF_4BPP, BMF_8BPP, BMF_16BPP, BMF_24BPP e BMF_32BPP.

Retornar valor

O valor retornado é um identificador que identifica o bitmap se a função for bem-sucedida. Caso contrário, ele será zero e um código de erro será registrado.

Comentários

A superfície deve ser associada usando EngAssociateSurface. O bitmap deve ser excluído chamando EngDeleteSurface quando ele não for mais necessário.

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

Confira também

EngCreateBitmap