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 |