GetBitmapBits

La función GetBitmapBits copia los bits de un mapa de bits especificado en un buffer.

Esta función no está implementada en el API de Win32. Se proporciona para compatibilidad con versiones de Windows de 16 bits. Las aplicaciones basadas en Win32 deben usar la función GetDIBits.

Sintaxis

LONG GetBitmapBits(
    HBITMAP hbmp,   // manipulador de mapa de bits
    LONG cbBuffer,  // número de bytes a copiar en el buffer
    LPVOID lpvBits  // dirección del buffer para los bits del mapa de bits
   );

Parámetros

hbmp: identifica el mapa de bits de interés.

cbBuffer: especifica el número de bytes a copiar.

lpvBits: apunta a un buffer que recibirá los bits del mapa de bits. Se almacenan como un array de valores byte.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el número de bytes en el mapa de bits.

Si la función falla, el valor de retorno es cero. Para obtener información complementaria de error, llamar a la función GetLastError

Observaciones

Los bits en el buffer de destino deben estar alienados por palabras. En otras palabras, el buffer debe empezar en una dirección de memoria par.