THORLABS DCU223x Operation Manual And Sdk page 203

Return values
When used with
DR_CHECK_COMPATIBILITY
IS_DR_CANNOT_CREATE_SURFACE
IS_DR_CANNOT_CREATE_TEXTURE
IS_DR_CANNOT_CREATE_VERTEX_BUFFER
IS_DR_CANNOT_GET_OVERLAY_DC
IS_DR_CANNOT_LOCK_OVERLAY_SURFACE
IS_DR_CANNOT_RELEASE_OVERLAY_DC
IS_DR_CANNOT_UNLOCK_OVERLAY_SURFACE
IS_DR_DEVICE_CAPS_INSUFFICIENT
IS_DR_DEVICE_OUT_OF_MEMORY
IS_DR_NOT_ALLOWED_WHILE_DC_IS_ACTIVE
IS_INVALID_CAMERA_HANDLE
IS_INVALID_PARAMETER
IS_NO_SUCCESS
IS_NOT_SUPPORTED
IS_SUCCESS
IS_TIMED_OUT
Related functions
is_SetDisplayMode()
is_SetColorMode()
is_SetImageMem()
is_RenderBitmap()
Example Supported function
UINT nType = IS_SET_DM_DIRECT3D;
if (is_DirectRenderer(m_pMainView->GetCameraHandle(), DR_GET_SUPPORTED,
{
// Direct3D is supported
}
nType = IS_SET_DM_OPENGL;
if (is_DirectRenderer(m_pMainView->GetCameraHandle(), DR_GET_SUPPORTED,
{
// OpenGL is supported
}
Example DC handle
//------------------------------------
// DC-Handle
//------------------------------------
// Get DC handle for Overlay
HDC hDC;
is_DirectRenderer (hCam, DR_GET_OVERLAY_DC, (void*)&hDC,
// Release DC handle
is_DirectRenderer (hCam, DR_RELEASE_OVERLAY_DC, NULL, NULL);
© 2013 Thorlabs GmbH
322
319
337
297
(void*)&nType, sizeof(nType)) == IS_SUCCESS)
(void*)&nType, sizeof(nType)) == IS_SUCCESS)
IS_DR_DEVICE_CAPS_INSUFFICIENT
The graphics hardware does not fully support the uc480
Direct3D functions.
The image surface or overlay surface could not be
created.
The texture could not be created.
The vertex buffer could not be created.
Could not get the device context handle for the overlay.
The overlay surface could not be locked.
Could not release the device context handle for the
overlay.
The overlay surface could not be unlocked.
Function is not supported by the graphics hardware.
Not enough graphics memory available.
A device context handle is still open in the application.
Invalid camera handle
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not
available in this mode.
General error message
The camera model used here does not support this
function or setting.
Function executed successfully
A timeout occurred. An image capturing process could
not be terminated within the allowable period.
sizeof (hDC));
4 Programming (SDK)
201