Função DrvCreateDeviceBitmap (winddi.h)

A função DrvCreateDeviceBitmap cria e gerencia bitmaps.

Sintaxe

HBITMAP DrvCreateDeviceBitmap(
  DHPDEV dhpdev,
  SIZEL  sizl,
  ULONG  iFormat
);

Parâmetros

dhpdev

Manipule para o PDEV que descreve o dispositivo físico que um aplicativo designou como o destino primário para um bitmap. O formato do bitmap deve ser compatível com esse dispositivo físico.

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 .

iFormat

Especifica o formato bitmap, que indica o número necessário de bits de informações de cor por pixel e sempre corresponde ao formato do primário. Este valor pode ser um dos seguintes:

Valor retornado

O valor retornado é um identificador que identifica o bitmap criado se a função for bem-sucedida. Se o driver optar por permitir que a GDI crie e gerencie o bitmap, o valor retornado será zero. Se ocorrer um erro, o valor retornado será 0xFFFFFFFF e a GDI registrará um código de erro em log.

Comentários

Se o driver criar o bitmap, ele poderá armazená-lo em qualquer lugar e em qualquer formato. Supõe-se que o driver levará em conta as especificações dos parâmetros e fornecerá um bitmap com pelo menos quantos bits por pixel forem solicitados.

O conteúdo do bitmap criado é indefinido.

Essa função é opcional. No entanto, se essa função for implementada, DrvDeleteDeviceBitmap também deverá ser implementado.

Requisitos

Confira também

DrvDeleteDeviceBitmap