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]

Image

Handle 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]	Image	Handle of image object.
[in]	iCmd	ID of the command to be called.
[in]	pInBuf	Arguments of the command as a binary buffer.
[in]	iInBufSize	Size of the input buffer.
[out]	pOutBuf	Output oof the command as a binary buffer.
[out]	iOutBufSize	Size 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]	Image	Handle of image object.
[in]	iCmd	ID of the command to be called.
[in]	pInStr	Arguments of the command as a string.
[in]	iInStrSize	Size of the input string.
[out]	pOutStr	Output of the command as a string.
[out]	iOutStrSize	Size 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)