Home > C: Programming > Obsolete Functions > History back  Previous chapter  Next chapter  Print  

is_LockDDOverlayMem

uEye Camera Manual Version 3.80

is_LockDDOverlayMem

Windows_Logo

Linux_Logo

USB 2.0

GigE

-

Syntax

INT is_LockDDOverlayMem(HIDS hCam, void** ppMem, INT* pPitch)

Description

Achtung

This function is obsolete and should not be used anymore. We recommend to use the is_DirectRenderer() function instead (see also Obsolete Functions).

In DirectDraw BackBuffer mode, is_LockDDOverlayMem() enables access to the overlay memory and returns the pointer to the starting address of the overlay buffer. This way, you can write data directly to the overlay buffer without the need to use the Windows GDI functions.

pPitch returns the line offset (in bytes) from the beginning of a line to the beginning of the next line. Make sure to release the memory again as early as possible using the is_UnlockDDOverlayMem() function.

While a LockDDOverlayMem...UnlockDDOverlayMem block is executed, the contents of the overlay buffer will not be refreshed on the screen.

Input Parameters

hCam

Camera handle

ppMem

Pointer to the variable that holds the address pointer

pPitch

Pointer to the variable that holds the pitch value

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Related Functions

Is_UnlockDDOverlayMem()
is_LockDDMem()
is_UnlockDDMem()
is_LockSeqBuf()
is_UnlockSeqBuf()

 


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com