get_compute_device_paramT_get_compute_device_paramGetComputeDeviceParamGetComputeDeviceParam (Operator)

Name

get_compute_device_paramT_get_compute_device_paramGetComputeDeviceParamGetComputeDeviceParam — Query compute device parameters.

Signature

get_compute_device_param( : : DeviceHandle, GenParamName : GenParamValue)

Herror T_get_compute_device_param(const Htuple DeviceHandle, const Htuple GenParamName, Htuple* GenParamValue)

void GetComputeDeviceParam(const HTuple& DeviceHandle, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HComputeDevice::GetComputeDeviceParam(const HString& GenParamName) const

HTuple HComputeDevice::GetComputeDeviceParam(const char* GenParamName) const

HTuple HComputeDevice::GetComputeDeviceParam(const wchar_t* GenParamName) const   (Windows only)

static void HOperatorSet.GetComputeDeviceParam(HTuple deviceHandle, HTuple genParamName, out HTuple genParamValue)

HTuple HComputeDevice.GetComputeDeviceParam(string genParamName)

Description

get_compute_device_paramget_compute_device_paramGetComputeDeviceParamGetComputeDeviceParamGetComputeDeviceParam returns parameters of the compute device DeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle for the current HALCON thread.

The following parameters can be queried (for more detailed descriptions sie set_compute_device_paramset_compute_device_paramSetComputeDeviceParamSetComputeDeviceParamSetComputeDeviceParam):

'alloc_pinned'

If 'true', the output image matrices of all operators are created in page locked (so called 'pinned') memory.

'asynchronous_execution'

If 'true', operators executed on the compute device do not wait for the device computations to finish but return after initiation the computations.

'buffer_cache_capacity'

Maximum size (in bytes) of the compute device buffer cache.

'buffer_cache_used'

Current size (in bytes) of the compute device buffer cache.

'image_cache_capacity'

Maximum size (in bytes) of the compute device image cache.

'image_cache_used'

Current size (in bytes) of the compute device image cache.

'pinned_mem_cache_capacity'

Maximum size (in bytes) of the page locked (pinned) memory cache.

'pinned_mem_cache_used'

Current size (in bytes) of the page locked (pinned) memory cache.

Execution Information

Parameters

DeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle (input_control)  compute_device HComputeDevice, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Compute device handle.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the parameter to query.

Default value: 'buffer_cache_capacity' "buffer_cache_capacity" "buffer_cache_capacity" "buffer_cache_capacity" "buffer_cache_capacity"

List of values: 'alloc_pinned'"alloc_pinned""alloc_pinned""alloc_pinned""alloc_pinned", 'asynchronous_execution'"asynchronous_execution""asynchronous_execution""asynchronous_execution""asynchronous_execution", 'buffer_cache_capacity'"buffer_cache_capacity""buffer_cache_capacity""buffer_cache_capacity""buffer_cache_capacity", 'buffer_cache_used'"buffer_cache_used""buffer_cache_used""buffer_cache_used""buffer_cache_used", 'image_cache_capacity'"image_cache_capacity""image_cache_capacity""image_cache_capacity""image_cache_capacity", 'image_cache_used'"image_cache_used""image_cache_used""image_cache_used""image_cache_used", 'pinned_mem_cache_capacity'"pinned_mem_cache_capacity""pinned_mem_cache_capacity""pinned_mem_cache_capacity""pinned_mem_cache_capacity", 'pinned_mem_cache_used'"pinned_mem_cache_used""pinned_mem_cache_used""pinned_mem_cache_used""pinned_mem_cache_used"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (output_control)  string(-array) HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Value of the parameter.

Result

The operator get_compute_device_paramget_compute_device_paramGetComputeDeviceParamGetComputeDeviceParamGetComputeDeviceParam returns the value 2 (H_MSG_TRUE) if the parameters are correct. Otherwise an exception will be raised.

Possible Predecessors

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceActivateComputeDeviceActivateComputeDevice

See also

set_compute_device_paramset_compute_device_paramSetComputeDeviceParamSetComputeDeviceParamSetComputeDeviceParam, get_compute_device_infoget_compute_device_infoGetComputeDeviceInfoGetComputeDeviceInfoGetComputeDeviceInfo

Module

Foundation