DiveBeginImageBufferAccess - Syntax

This function must be called before reading or writing data in a buffer allocated with DiveAllocImageBuffer. Depending on the underlying hardware implementation, this function might result in the frame buffer access being serialized (see DiveAcquireFrameBuffer). Once the caller has completed accessing (reading or writing) the image buffer, DiveEndImageBufferAccess must be called. Note that the pointer to the allocated buffer and line size are returned by this function, and these values might change from one image buffer access to the next.

#include <dive.h>

HDIVE      hDiveInst;               /*  Display engine DIVE instance. */
ULONG      ulBufferNumber;          /*  Buffer number being requested. */
PBYTE     *ppbImageBuffer;          /*  Pointer to pointer. */
PULONG     pulBufferScanLineBytes;  /*  Pointer to scan line size. */
PULONG     pulBufferScanLines;      /*  Pointer to # of scan lines. */
ULONG      rc;                      /*  Return codes. */

rc = DiveBeginImageBufferAccess(hDiveInst,
       ulBufferNumber, ppbImageBuffer, pulBufferScanLineBytes,
       pulBufferScanLines);