StoreImage

Transfers image data from the frame buffer to memory

int StoreImage (
        RECT *recp,
        u_long *p
)

Arguments

recp Pointer to the source rectangular area in the frame buffer
p Pointer to the upper left-hand corner of the destination rectangular area in main memory

Return Value

The slot number of the GPU’s draw/command queue where the command resides is returned.

Explanation

Data from the rectangular area pointed to by recp is transferred to the destination rectangular area in main memory pointed to by p.

Notes

StoreImage() is a non-blocking function, therefore DrawSync() must be used to determine the completion of transfer. The transfer is not affected by clipping or offsetting that may be in effect for the drawing environment. The transfer area must be located within a drawable area: (0,0) - (1023,511).