Función DdCreateDIBSection (ddrawgdi.h)
[Esta función está sujeta a cambios con cada revisión del sistema operativo. En su lugar, use Microsoft DirectDraw y Microsoft Direct3DAPIs; estas API aíslan las aplicaciones de estos cambios en el sistema operativo y ocultan muchas otras dificultades implicadas en la interacción directa con los controladores de pantalla.
Crea una estructura DIBSECTION que comparte su tabla de colores con el dispositivo.
GdiEntry9 se define como alias para esta función.
Sintaxis
HBITMAP DdCreateDIBSection(
HDC hdc,
const BITMAPINFO *pbmi,
UINT iUsage,
VOID **ppvBits,
HANDLE hSectionApp,
DWORD dwOffset
);
Parámetros
hdc
Un controlador de dominio válido compatible con el dispositivo de pantalla actual.
pbmi
Puntero a una estructura BITMAPINFO que describe la DIBSECTION solicitada.
iUsage
Especifica el tipo de datos contenidos en el miembro de matriz imcColors de la estructura BITMAPINFO a la que apunta pbmi (índices de paleta lógica o valores RGB literales). Se definen los valores siguientes.
(DIB_PAL_COLORS)
El miembro imcColors es una matriz de índices de 16 bits en la paleta lógica del contexto del dispositivo especificado por hdc.
(DIB_RGB_COLORS)
La estructura BITMAPINFO contiene una matriz de valores RGB literales.
ppvBits
Puntero a un puntero a los datos DIBSECTION creados.
hSectionApp
Reservado. Debe ser NULL.
dwOffset
Valor devuelto
Si se ejecuta correctamente, esta función devuelve un identificador a un mapa de bits que representa la DIBSECTION; de lo contrario, devuelve NULL.
Comentarios
Llamar a esta función garantiza una paleta de identidades y ninguna conversión de paleta cuando se llama a IDirectDrawSurface7::Blt o StretchBlt .
Se recomienda que las aplicaciones usen IDirectDrawSurface7, que puede crear superficies de paleta de identidades de 8 bits por píxel de forma independiente del sistema operativo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | ddrawgdi.h |