Skip to content

release_compute_deviceReleaseComputeDeviceReleaseComputeDevicerelease_compute_deviceT_release_compute_device🔗

Short description🔗

release_compute_deviceReleaseComputeDeviceReleaseComputeDevicerelease_compute_deviceT_release_compute_device — Close a compute_device.

Warning🔗

release_compute_deviceReleaseComputeDevice must not be used in HDevelop!

Signature🔗

release_compute_device( compute_device DeviceHandle )void ReleaseComputeDevice( const HTuple& DeviceHandle )static void HOperatorSet.ReleaseComputeDevice( HTuple deviceHandle )def release_compute_device( device_handle: HHandle ) -> None

Herror T_release_compute_device( const Htuple DeviceHandle )

void HComputeDevice::ReleaseComputeDevice( ) const

void HComputeDevice.ReleaseComputeDevice( )

Description🔗

release_compute_deviceReleaseComputeDevice closes a compute devices for the current HALCON thread and frees all resources associated to DeviceHandledeviceHandledevice_handle. release_compute_deviceReleaseComputeDevice is solely for the purpose of freeing all device related resources before unloading the HALCON library, if the library was loaded using a mechanism like LoadLibrary or dlopen. In all other cases you must not use release_compute_deviceReleaseComputeDevice!

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).

  • Processed without parallelization.

Parameters🔗

DeviceHandledeviceHandledevice_handle (input_control) compute_device → (handle)HTuple (HHandle)HComputeDevice, HTuple (IntPtr)HHandleHtuple (handle)

Compute device handle.

Result🔗

release_compute_deviceReleaseComputeDevice returns the value 2 (H_MSG_TRUE) if DeviceHandledeviceHandledevice_handle was closed successfully. Otherwise an exception will be raised.

Combinations with other operators🔗

Combinations

See also

release_all_compute_devicesReleaseAllComputeDevices, deactivate_compute_deviceDeactivateComputeDevice, deactivate_all_compute_devicesDeactivateAllComputeDevices

Module🔗

Foundation