DiveAllocImageBuffer - Syntax

This function allocates a buffer to contain an image. Source data buffers passed to DiveBlitImage must be allocated with this function in order to take advantage of hardware acceleration features of some display hardware.

#include <dive.h>

HDIVE     hDiveInst;        /*  Display engine DIVE instance. */
PULONG    pulBufferNumber;  /*  Buffer number allocated. */
FOURCC    fccColorSpace;    /*  Pel format of image color space. */
ULONG     ulWidth;          /*  Width of DIVE memory to allocate. */
ULONG     ulHeight;         /*  Height of DIVE memory to allocate. */
ULONG     ulLineSizeBytes;  /*  Suggested scan line size. */
PBYTE     pbImageBuffer;    /*  Image buffer. */
ULONG     rc;               /*  Return codes. */

rc = DiveAllocImageBuffer(hDiveInst, pulBufferNumber,
       fccColorSpace, ulWidth, ulHeight, ulLineSizeBytes,
       pbImageBuffer);