DrvCreateDeviceBitmap

9/8/2008

Essa função cria e gerencia arquivos bitmap.

Syntax

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

Parameters

• dhpdev
  [no] PDEV que descreve o físico dispositivo que um aplicativo foi designado como o primário destino para um bitmap. O formato do bitmap deve ser compatível com esta físico dispositivo.

• sizl
  [no] SIZEL estrutura que contém a largura e altura do bitmap a ser criado. O CX e CY membros dessa estrutura contêm respectivamente, de o bitmap largura e altura, em pixels. A SIZEL estrutura é idêntica a um SIZE estrutura.

• iFormat
  [no] Formato de bitmap, que indica o exigido número de bits de cor informações por pixel e sempre coincide com o formato do primário. A seguinte tabela mostra os valores possíveis. Defina como um desses valores.

  Valor	Descrição
  BMF_8BPP	8 bits por pixel.
  BMF_16BPP	16 bits por pixel.
  BMF_24BPP	24 bits por pixel.
  BMF_32BPP	32 bits por pixel.

Return Value

Identificador que identifica o bitmap criado se a função é bem-sucedido. Se o driver optar por permitir que GDI criar e gerenciar o bitmap, o valor de retorno é zero. Se um erro ocorrer, o valor de retorno é 0xFFFFFFFF e GDI efetua um código de erro.

Remarks

Se o driver cria o bitmap, ele pode armazená-lo em qualquer lugar e em qualquer formato. Pressupõe-se que o driver será levar em conta as especificações dos parâmetros e fornecer um bitmap com pelo menos quantos bits por pixel, conforme solicitado.

O conteúdo de bitmap criado é indefinido.

Requirements

Header	winddi.h
Library	Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, Ddi_tvia5_lib.lib
Windows Embedded CE	Windows CE 1.0 and later

See Also

Reference

DrvDeleteDeviceBitmap

Other Resources

Display Drivers
SIZE