init_compute_deviceT_init_compute_deviceInitComputeDeviceinit_compute_deviceInitComputeDeviceInitComputeDevice (Operator)

Name

init_compute_deviceT_init_compute_deviceInitComputeDeviceinit_compute_deviceInitComputeDeviceInitComputeDevice — Initialize a compute device.

Signature

Description

init_compute_deviceinit_compute_deviceInitComputeDeviceinit_compute_deviceInitComputeDeviceInitComputeDevice initializes a compute device and prepares a list of operators given in OperatorsOperatorsOperatorsOperatorsOperatorsoperators for the execution on this device. Further the device is activated for the current thread. If init_compute_deviceinit_compute_deviceInitComputeDeviceinit_compute_deviceInitComputeDeviceInitComputeDevice is not called or operators other than those in OperatorsOperatorsOperatorsOperatorsOperatorsoperators are used on the device, the initialization is performed on demand.

Use get_operator_infoget_operator_infoGetOperatorInfoget_operator_infoGetOperatorInfoGetOperatorInfo to test if an operator qualifies for execution on the compute device.

Attention

Be aware that the execution time of init_compute_deviceinit_compute_deviceInitComputeDeviceinit_compute_deviceInitComputeDeviceInitComputeDevice depends on the number of OperatorsOperatorsOperatorsOperatorsOperatorsoperators and may last up to several seconds.

Parallelization

• 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

Result

The operator init_compute_deviceinit_compute_deviceInitComputeDeviceinit_compute_deviceInitComputeDeviceInitComputeDevice returns the value 2 (H_MSG_TRUE) if the initialization was successful. Otherwise an exception will be raised.

Possible Predecessors

query_available_compute_devicesquery_available_compute_devicesQueryAvailableComputeDevicesquery_available_compute_devicesQueryAvailableComputeDevicesQueryAvailableComputeDevices, open_compute_deviceopen_compute_deviceOpenComputeDeviceopen_compute_deviceOpenComputeDeviceOpenComputeDevice

Possible Successors

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice

Module

Foundation