Estrutura DIBSECTION (wingdi.h)

Artigo
03/13/2024

A estrutura DIBSECTION contém informações sobre um DIB criado chamando a função CreateDIBSection . Uma estrutura DIBSECTION inclui informações sobre dimensões do bitmap, formato de cor, máscaras de cores, objeto de mapeamento de arquivo opcional e deslocamento de armazenamento de valores de bit opcionais. Um aplicativo pode obter uma estrutura DIBSECTION preenchida para um determinado DIB chamando a função GetObject .

Sintaxe

typedef struct tagDIBSECTION {
  BITMAP           dsBm;
  BITMAPINFOHEADER dsBmih;
  DWORD            dsBitfields[3];
  HANDLE           dshSection;
  DWORD            dsOffset;
} DIBSECTION, *LPDIBSECTION, *PDIBSECTION;

Membros

dsBm

Uma estrutura de dados BITMAP que contém informações sobre o DIB: seu tipo, suas dimensões, suas capacidades de cor e um ponteiro para seus valores de bit.

dsBmih

Uma estrutura BITMAPINFOHEADER que contém informações sobre o formato de cor do DIB.

dsBitfields[3]

Especifica três máscaras de cores para o DIB. Esse campo só é válido quando o membro BitCount da estrutura BITMAPINFOHEADER tem um valor maior que 8. Cada máscara de cores indica os bits usados para codificar um dos três canais de cores (vermelho, verde e azul).

dshSection

Contém um identificador para o objeto de mapeamento de arquivo que a função CreateDIBSection usou para criar o DIB. Se CreateDIBSection tiver sido chamado com um valor NULL para seu parâmetro hSection , fazendo com que o sistema aloque memória para o bitmap, o membro dshSection será NULL.

dsOffset

O deslocamento para os valores de bit do bitmap dentro do objeto de mapeamento de arquivo referenciado por dshSection. Se dshSection for NULL, o valor dsOffset não terá nenhum significado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	wingdi.h (inclua Windows.h)