Função DdCreateDIBSection (ddrawgdi.h)

[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o Microsoft DirectDraw e o Microsoft Direct3DAPIs; essas APIs isolam os aplicativos dessas alterações do sistema operacional e ocultam muitas outras dificuldades envolvidas na interação diretamente com drivers de exibição.]

Cria uma estrutura DIBSECTION que compartilha sua tabela de cores com o dispositivo.

GdiEntry9 é definido como um alias para essa função.

Sintaxe

HBITMAP DdCreateDIBSection(
  HDC              hdc,
  const BITMAPINFO *pbmi,
  UINT             iUsage,
  VOID             **ppvBits,
  HANDLE           hSectionApp,
  DWORD            dwOffset
);

Parâmetros

hdc

Um DC válido compatível com o dispositivo de exibição atual.

pbmi

Ponteiro para uma estrutura BITMAPINFO que descreve o DIBSECTION solicitado.

iUsage

Especifica o tipo de dados contidos no membro da matriz bmiColors da estrutura BITMAPINFO apontada por pbmi (índices de paleta lógica ou valores RGB literais). Os valores a seguir são definidos.

(DIB_PAL_COLORS)

O membro bmiColors é uma matriz de índices de 16 bits na paleta lógica do contexto do dispositivo especificado pelo hdc.

(DIB_RGB_COLORS)

A estrutura BITMAPINFO contém uma matriz de valores RGB literais.

ppvBits

Ponteiro para um ponteiro para os dados DIBSECTION criados.

hSectionApp

Reservado. Deve ser NULL.

dwOffset

Retornar valor

Se tiver êxito, essa função retornará um identificador para um bitmap que representa o DIBSECTION; caso contrário, retornará NULL.

Comentários

Chamar essa função garante uma paleta de identidade e nenhuma conversão de paleta quando IDirectDrawSurface7::Blt ou StretchBlt são chamados.

Os aplicativos são aconselhados a usar IDirectDrawSurface7, que pode criar superfícies de 8 bits por pixel e paletas de identidade de uma maneira independente do sistema operacional.

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]
Plataforma de Destino	Windows
Cabeçalho	ddrawgdi.h

Confira também

Suporte ao cliente de baixo nível de gráficos