Please enable JavaScript to view this site.

IDS Software Suite - obsolete functions 4.97

Windows_Logo
Linux_Logo

USB 2.0

GigE

-

Syntax

INT is_GetDC (HIDS hCam, HDC* phDC)

Description

hint_info

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

In DirectDraw BackBuffer mode, is_GetDC() returns the device context handle of the overlay buffer. Using this handle, it is possible to access the overlay using the Windows GDI functionality. Thus, all Windows graphics commands such as Line, Circle, Rectangle, TextOut, … are available. You should release the device context handle as early as possible using the is_ReleaseDC() function. While a GetDC...ReleaseDC block is executed, the overlay buffer on the screen will not be updated.

Input parameters

hCam

Camera handle

phDC

Pointer to the variable that is supposed to contain the device context handle

Return values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Related functions

is_ReleaseDC()

is_ShowDDOverlay()

is_DisableDDOverlay()

is_EnableDDOverlay()

is_GetDDOvlSurface()

is_SetDisplayMode()