Is_Lockddoverlaymem - THORLABS DCU223x Operation Manual And Sdk

4.5.17 is_LockDDOverlayMem

USB 2.0
Syntax
INT is_LockDDOverlayMem(HIDS hCam, void** ppMem, INT* pPitch)
Description
Attention
This function is obsolete and should not be used anymore. We recommend to use the
function instead (see also
198
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
While a LockDDOverlayMem ... UnlockDDOverlayMem block is executed, the contents of the overlay buffer will
not be refreshed on the screen.
Input parameters
hCam
ppMem
pPitch
Return values
IS_SUCCESS
IS_NO_SUCCESS
Related functions
is_UnlockDDOverlayMem()
is_LockDDMem()
400
is_UnlockDDMem()
is_LockSeqBuf()
is_UnlockSeqBuf()
© 2013 Thorlabs GmbH
-
Obsolete functions
449
448
289
354
).
379
is_UnlockDDOverlayMem()
Camera handle
Pointer to the variable that holds the address pointer
Pointer to the variable that holds the pitch value
Function executed successfully
General error message
4 Programming (SDK)
is_DirectRenderer()
function.
449
401