Image Manager (CVCDriver.dll) 14.0
IDeviceControl

Interface for controlling device related properties. More...

Functions

cvbbool_t CanDeviceControl (IMG Image)
 This function verifies whether the image supports the DeviceControl interface. More...
 
cvbres_t DCBinaryCommand (IMG Image, DEVICECTRL_CMD iCmd, const void *pInBuf, size_t iInBufSize, void *pOutBuf, size_t &iOutBufSize)
 This function sends a binary command directly to the CVB driver. More...
 
cvbres_t DCStrCommand (IMG Image, DEVICECTRL_CMD iCmd, const char *pInStr, size_t iInStrSize, char *pOutStr, size_t &iOutStrSize)
 This function sends a string command directly to the CVB driver. More...
 

Detailed Description

Interface for controlling device related properties.

Former way of configuring a device. Please use INodeMapHandle2.

Function Documentation

◆ CanDeviceControl()

cvbbool_t CanDeviceControl ( IMG  Image)

This function verifies whether the image supports the DeviceControl interface.

Refer to the CVB Driver User Guide for your image acquisition device to check the list of supported interfaces.

Parameters
[in]ImageHandle of image object.
Returns
TRUE if the image supports the DeviceControl interface, FALSE otherwise.
Supported platforms:
Win32
Win64
Linux
Related Topics:
CanDeviceControl property of the Grabber Control.
Examples:
Visual Basic - VB Grabber OCX Example
Visual C++ - VC MDI Example (DLL only)

◆ DCBinaryCommand()

cvbres_t DCBinaryCommand ( IMG  Image,
DEVICECTRL_CMD  iCmd,
const void *  pInBuf,
size_t  iInBufSize,
void *  pOutBuf,
size_t &  iOutBufSize 
)

This function sends a binary command directly to the CVB driver.

Commands are driver dependent. A binary command is defined by its ID and its parameter buffer which are passed to the function. pOutBuf and iOutBufSize are returned values indicating the answer to the command in form of a binary buffer and the length of this buffer. To determine the size of an answer buffer for a given command pass a NULL pointer in the pOutBuf argument. The size needed for the command is then given in the iOutBufSize argument.

Refer to the CVB Driver User Guide for your image acquisition device to check the list of supported interfaces.

Parameters
[in]ImageHandle of image object.
[in]iCmdID of the command to be called.
[in]pInBufArguments of the command as a binary buffer.
[in]iInBufSizeSize of the input buffer.
[out]pOutBufOutput oof the command as a binary buffer.
[out]iOutBufSizeSize of the output buffer.
Returns
0 : OK
<0 : an error occured
Supported platforms:
Win32
Win64
Linux
Related Topics:
SendBinaryCommand method of the Grabber Control.
Examples:
Special example programs are available for the selected Image Acquisition Hardware, means Framegrabber or Cameras. Please have a look at the directory CVB/Hardware/..

Visual Basic - VB Grabber OCX Example
Visual C++ - VC MDI Example (DLL only)

◆ DCStrCommand()

cvbres_t DCStrCommand ( IMG  Image,
DEVICECTRL_CMD  iCmd,
const char *  pInStr,
size_t  iInStrSize,
char *  pOutStr,
size_t &  iOutStrSize 
)

This function sends a string command directly to the CVB driver.

Commands are driver dependent. A string command is defined by its ID and its parameter string which is passed to the function. Parameters are seperated by a semicolon (;). pOutStr and iOutStrSize are returned values indicating the answer to the command in form of a string and the length of this string. To determine the size of an answer string for a given command pass a NULL string in the pOutStr argument. The size needed for the command is then given in the iOutStrSize argument.

Refer to the CVB Driver User Guide for your image acquisition device to check the list of supported interfaces.

Parameters
[in]ImageHandle of image object.
[in]iCmdID of the command to be called.
[in]pInStrArguments of the command as a string.
[in]iInStrSizeSize of the input string.
[out]pOutStrOutput of the command as a string.
[out]iOutStrSizeSize of the output string.
Returns
0 : OK
<0 : an error occured
Supported platforms:
Win32
Win64
Linux
Related Topics:
SendStringCommand method of the Grabber Control.
Examples:
Visual Basic - VB Grabber OCX Example
Visual C++ - VC MDI Example (DLL only)